> ## Documentation Index
> Fetch the complete documentation index at: https://langwatch.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Report batch evaluation results

> Report the rows of a batch evaluation against an experiment, so its scores and progress show up in the app. This is the second half of an SDK batch evaluation: create the experiment with `POST /api/experiment/init`, then post rows here as they finish. Identify the experiment by either `experiment_id` or `experiment_slug`. Bodies up to 20MB are accepted.



## OpenAPI

````yaml POST /api/evaluations/batch/log_results
openapi: 3.1.0
info:
  title: LangWatch API
  version: 1.0.0
  description: LangWatch openapi spec
servers:
  - url: https://app.langwatch.ai
security:
  - project_api_key: []
paths:
  /api/evaluations/batch/log_results:
    post:
      tags:
        - Evaluations
      summary: Report batch evaluation results
      description: >-
        Report the rows of a batch evaluation against an experiment, so its
        scores and progress show up in the app. This is the second half of an
        SDK batch evaluation: create the experiment with `POST
        /api/experiment/init`, then post rows here as they finish. Identify the
        experiment by either `experiment_id` or `experiment_slug`. Bodies up to
        20MB are accepted.
      operationId: postApiEvaluationsBatchLog_results
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              allOf:
                - type: object
                  properties:
                    run_id:
                      type: string
                    workflow_version_id:
                      type: string
                      nullable: true
                    progress:
                      type: number
                      nullable: true
                    total:
                      type: number
                      nullable: true
                    dataset:
                      type: array
                      items:
                        type: object
                        properties:
                          index:
                            type: number
                          target_id:
                            type: string
                            nullable: true
                          entry:
                            type: object
                            additionalProperties: {}
                          predicted:
                            type: object
                            additionalProperties: {}
                          cost:
                            type: number
                            nullable: true
                          duration:
                            type: number
                            nullable: true
                          error:
                            type: string
                            nullable: true
                          trace_id:
                            type: string
                            nullable: true
                        required:
                          - index
                          - entry
                        additionalProperties: false
                    evaluations:
                      type: array
                      items:
                        type: object
                        properties:
                          evaluator:
                            type: string
                          name:
                            type: string
                            nullable: true
                          target_id:
                            type: string
                            nullable: true
                          status:
                            anyOf:
                              - type: string
                                enum:
                                  - processed
                              - type: string
                                enum:
                                  - skipped
                              - type: string
                                enum:
                                  - error
                          index:
                            type: number
                          duration:
                            type: number
                            nullable: true
                          inputs:
                            type: object
                            additionalProperties: {}
                          score:
                            type: number
                            nullable: true
                          label:
                            type: string
                            nullable: true
                          passed:
                            type: boolean
                            nullable: true
                          details:
                            type: string
                            nullable: true
                          cost:
                            type: number
                            nullable: true
                        required:
                          - evaluator
                          - status
                          - index
                        additionalProperties: false
                - type: object
                  properties:
                    experiment_id:
                      type: string
                      nullable: true
                    experiment_slug:
                      type: string
                      nullable: true
                    run_id:
                      type: string
                      nullable: true
                    workflow_id:
                      type: string
                      nullable: true
                    name:
                      type: string
                      nullable: true
                    targets:
                      type: array
                      items:
                        allOf:
                          - type: object
                            properties:
                              id:
                                type: string
                              name:
                                type: string
                              prompt_id:
                                type: string
                                nullable: true
                              prompt_version:
                                type: number
                                nullable: true
                              agent_id:
                                type: string
                                nullable: true
                              evaluator_id:
                                type: string
                                nullable: true
                              model:
                                type: string
                                nullable: true
                              metadata:
                                type: object
                                additionalProperties:
                                  anyOf:
                                    - type: string
                                    - type: number
                                    - type: boolean
                                nullable: true
                            required:
                              - id
                              - name
                          - type: object
                            properties:
                              type:
                                anyOf:
                                  - type: string
                                    enum:
                                      - prompt
                                  - type: string
                                    enum:
                                      - agent
                                  - type: string
                                    enum:
                                      - evaluator
                                  - type: string
                                    enum:
                                      - workflow
                                  - type: string
                                    enum:
                                      - custom
                      nullable: true
                    timestamps:
                      type: object
                      properties:
                        created_at:
                          type: number
                          nullable: true
                        finished_at:
                          type: number
                          nullable: true
                        stopped_at:
                          type: number
                          nullable: true
                      additionalProperties: false
                  required:
                    - run_id
      responses:
        '200':
          description: The rows were recorded
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: Human-readable confirmation
                required:
                  - message
        '400':
          description: >-
            The request was not sent as application/json, failed validation,
            named neither experiment_id nor experiment_slug, or carried
            timestamps in seconds rather than milliseconds
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: Set when the request was rejected before validation
                  error:
                    type: string
                    description: Set when the body parsed and then failed validation
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: The failure, as a sentence
                  kind:
                    type: string
                    description: Stable failure code, on the failures that carry one
                  meta:
                    type: object
                    additionalProperties: {}
                    description: >-
                      What the code needs to be acted on, such as the missing
                      field
                required:
                  - error
        '403':
          description: The API key lacks evaluations:manage
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: The failure, as a sentence
                  kind:
                    type: string
                    description: Stable failure code, on the failures that carry one
                  meta:
                    type: object
                    additionalProperties: {}
                    description: >-
                      What the code needs to be acted on, such as the missing
                      field
                required:
                  - error
components:
  securitySchemes:
    project_api_key:
      type: apiKey
      in: header
      name: X-Auth-Token
      description: >-
        Project API key for sending traces and accessing project-scoped
        resources. Format: sk-lw-... (no underscore). Obtain one by creating a
        project via the Admin API or the LangWatch UI.

````