> ## Documentation Index > Fetch the complete documentation index at: https://docs.galtea.ai/llms.txt > Use this file to discover all available pages before exploring further. # Create traces batch > Create multiple traces from conversation turns. Identify the session with exactly one of `sessionId` or `sessionCustomId` (same find-existing semantics as `POST /inferenceResults`). See [Traces](https://docs.galtea.ai/concepts/product/version/session/trace). The REST path `/inferenceResults` and the `inferenceResult*` JSON fields keep the old name of this entity. ## OpenAPI ````yaml https://api.galtea.ai/openapi.json post /inferenceResults/batch openapi: 3.0.0 info: version: 1.0.0 title: Product Management Service API description: API documentation for Product Management Service contact: name: Galtea AI servers: - url: https://api.galtea.ai security: - bearerAuth: [] tags: [] externalDocs: description: Galtea Platform Documentation url: https://docs.galtea.ai paths: /inferenceResults/batch: post: tags: - traces summary: Create traces batch description: > Create multiple traces from conversation turns. Identify the session with exactly one of `sessionId` or `sessionCustomId` (same find-existing semantics as `POST /inferenceResults`). See [Traces](https://docs.galtea.ai/concepts/product/version/session/trace). The REST path `/inferenceResults` and the `inferenceResult*` JSON fields keep the old name of this entity. operationId: createInferenceResultsBatch requestBody: required: true content: application/json: schema: type: object required: - conversationTurns properties: sessionId: type: string description: ID of the session. Provide this or `sessionCustomId`. example: session_123 sessionCustomId: type: string description: > Your own conversation id. An existing session with this custom id is found and appended to; if none matches the call returns a 400, so create the session first through the sessions API. Requires `versionId` or `productId`. Provide this or `sessionId`. example: my-conversation-42 versionId: type: string description: > Version anchor for the `sessionCustomId` lookup. Provide this or `productId`; if both are given, `versionId` wins. example: ver_123 productId: type: string description: > Product anchor for the `sessionCustomId` lookup when no `versionId` is given: the existing session with that custom id is found across the product's versions. example: prod_123 conversationTurns: type: array items: type: object responses: '201': description: Traces created successfully content: application/json: schema: type: array items: $ref: '#/components/schemas/InferenceResult' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Error' security: - bearerAuth: [] components: schemas: InferenceResult: type: object description: >- A trace: one conversation turn, holding the input and the agent output. The schema name, the `/inferenceResults` path and every `inferenceResult*` field still carry the old name of this entity, "inference result". Only the wording changed so far; the wire contract is renamed in a later API release. properties: id: type: string example: ir_123 sessionId: type: string example: session_123 userId: type: string nullable: true example: user_123 index: type: integer example: 0 description: Order index within the session status: type: string enum: - PENDING - GENERATED - FAILED - SKIPPED example: PENDING error: type: string nullable: true description: Error message explaining why this trace failed or was skipped example: null input: type: object nullable: true description: >- Structured input data. For plain text input, format is { user_message: "..." } example: user_message: User input text actualOutput: oneOf: - type: string - type: object nullable: true description: >- The agent turn output. Plain text by default (the scored scalar). For voice turns, an envelope { assistant_message, content: [{ type, uri, transcript }] } carrying audio parts — the scored scalar stays the canonical transcript. example: Model response latency: type: integer nullable: true example: 150 inputTokens: type: integer nullable: true example: 100 outputTokens: type: integer nullable: true example: 50 cacheReadInputTokens: type: integer nullable: true example: 20 tokens: type: integer nullable: true example: 150 description: Total tokens costPerInputToken: type: number nullable: true example: 0.00001 costPerOutputToken: type: number nullable: true example: 0.00003 costPerCacheReadInputToken: type: number nullable: true example: 0.000005 cost: type: number nullable: true example: 0.001 creditsUsed: type: integer nullable: true example: 1 droppedSpanCount: type: integer nullable: true example: 2 description: >- How many spans sent with this trace were refused, for example a span with an empty name or a negative latency. Null means none were refused. conversationSimulatorVersion: type: string nullable: true example: 1.0.0 traceId: type: string nullable: true example: a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4 description: >- W3C trace ID for the root span created during direct inference. This is the OpenTelemetry trace id, not the id of this Galtea trace, which is `id`. The same trace ID is propagated to the user endpoint via the traceparent header. createdAt: type: string format: date-time deletedAt: type: string format: date-time nullable: true comments: type: array description: Free-form reviewer annotations on this turn, oldest first. items: $ref: '#/components/schemas/Comment' Error: type: object properties: error: type: string example: Error type message: type: string example: Error message description Comment: type: object properties: id: type: string example: comment_123 inferenceResultId: type: string example: inferenceResult_123 text: type: string example: Agent hallucinated the price. tags: type: array items: type: string example: - hallucination - tone userId: type: string nullable: true example: user_123 userName: type: string nullable: true example: John Doe userEmail: type: string nullable: true format: email example: user@example.com createdAt: type: string format: date-time required: - id - inferenceResultId - text - tags - userId - userName - userEmail - createdAt securitySchemes: bearerAuth: type: http scheme: bearer description: >- API key authorization. Pass your API key in the Authorization header as a Bearer token. Both new (`gsk_*`) and legacy (`gsk-`) API keys are accepted, e.g. `Authorization: Bearer gsk_...` or `Authorization: Bearer gsk-...`. ````