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

# List immutable evaluation verdicts

> Returns an organization-scoped, newest-first page of immutable evaluator verdicts. Optional filters are combined with AND. Retained same-organization evaluation history remains readable after referenced sessions or agents are deleted; unknown and cross-organization references are indistinguishable 404 responses.



## OpenAPI

````yaml /managed-agents/openapi.yaml get /managed-agents/v1/evaluations
openapi: 3.1.0
info:
  title: Managed Agents API
  version: 0.14.0
  description: >-
    The Recursion Managed Agents REST API. Authenticate with a Recursion API key
    as a bearer token. An organization-scoped key acts in its own organization
    and needs nothing else; a tenant-scoped key must also send
    `x-organization-id` with an organization id or `default`. Field names follow
    each operation's published schema.
servers:
  - url: https://api.recursion.labelbox.com
security:
  - bearerAuth: []
paths:
  /managed-agents/v1/evaluations:
    get:
      tags:
        - Evaluations
      summary: List immutable evaluation verdicts
      description: >-
        Returns an organization-scoped, newest-first page of immutable evaluator
        verdicts. Optional filters are combined with AND. Retained
        same-organization evaluation history remains readable after referenced
        sessions or agents are deleted; unknown and cross-organization
        references are indistinguishable 404 responses.
      operationId: managedAgentsListManagedAgentEvaluations
      parameters:
        - description: >-
            Narrow to one target session. Unknown, deleted-without-history, and
            cross-organization ids return 404.
          in: query
          name: target_session_id
          schema:
            description: >-
              Narrow to one target session. Unknown, deleted-without-history,
              and cross-organization ids return 404.
            format: uuid
            type: string
        - description: >-
            Narrow to verdicts for one target agent. Retained same-organization
            history remains readable after deletion.
          in: query
          name: target_agent_id
          schema:
            description: >-
              Narrow to verdicts for one target agent. Retained
              same-organization history remains readable after deletion.
            format: uuid
            type: string
        - description: >-
            Narrow to verdicts produced by one evaluator agent. Retained
            same-organization history remains readable after deletion.
          in: query
          name: evaluator_agent_id
          schema:
            description: >-
              Narrow to verdicts produced by one evaluator agent. Retained
              same-organization history remains readable after deletion.
            format: uuid
            type: string
        - description: >-
            Narrow to one evaluation run, by the run_session_id
            listEvaluationRuns returns.
          in: query
          name: run_session_id
          schema:
            description: >-
              Narrow to one evaluation run, by the run_session_id
              listEvaluationRuns returns.
            format: uuid
            type: string
        - description: Maximum verdicts to return. Defaults to 50.
          in: query
          name: limit
          schema:
            default: 50
            description: Maximum verdicts to return. Defaults to 50.
            maximum: 100
            minimum: 1
            type: integer
        - description: >-
            Opaque signed continuation from next_page_token. It is bound to this
            organization, filters, and effective limit and expires after one
            hour.
          in: query
          name: page_token
          schema:
            description: >-
              Opaque signed continuation from next_page_token. It is bound to
              this organization, filters, and effective limit and expires after
              one hour.
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedAgentsEvaluationListResponse'
          description: >-
            One organization-scoped page of immutable evaluation verdicts and an
            optional continuation.
        '400':
          description: The request was rejected by schema or semantic validation.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedAgentsApiErrorInvalidRequest'
        '401':
          description: The caller is unauthenticated.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedAgentsApiErrorUnauthorized'
        '403':
          description: The caller lacks a required permission or capability.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedAgentsApiErrorForbidden'
        '404':
          description: No such resource is reachable for this caller.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedAgentsApiErrorNotFound'
        '429':
          headers:
            Retry-After:
              description: When to retry, as delay seconds or an HTTP date.
              schema:
                type: string
          description: A rate limit is exhausted. Honor `Retry-After`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedAgentsApiErrorRateLimitExceeded'
        '500':
          description: An unexpected server-side failure.
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/ManagedAgentsApiErrorInternalError'
                  - $ref: >-
                      #/components/schemas/ManagedAgentsApiErrorInvariantViolation
                discriminator:
                  propertyName: code
                  mapping:
                    internal_error:
                      $ref: '#/components/schemas/ManagedAgentsApiErrorInternalError'
                    invariant_violation:
                      $ref: >-
                        #/components/schemas/ManagedAgentsApiErrorInvariantViolation
        '502':
          description: The service returned an invalid response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedAgentsApiErrorBadGateway'
        '503':
          description: >-
            A dependency is unavailable. Consult details.retryable and
            Retry-After when present before retrying.
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: >-
                      #/components/schemas/ManagedAgentsApiErrorManagedAgentsUnavailable
                  - $ref: >-
                      #/components/schemas/ManagedAgentsApiErrorServiceUnavailable
                discriminator:
                  propertyName: code
                  mapping:
                    managed_agents_unavailable:
                      $ref: >-
                        #/components/schemas/ManagedAgentsApiErrorManagedAgentsUnavailable
                    service_unavailable:
                      $ref: >-
                        #/components/schemas/ManagedAgentsApiErrorServiceUnavailable
        '504':
          description: The service did not respond before the timeout.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedAgentsApiErrorGatewayTimeout'
components:
  schemas:
    ManagedAgentsEvaluationListResponse:
      additionalProperties: false
      description: >-
        One organization-scoped page of immutable evaluation verdicts and an
        optional continuation.
      properties:
        evaluations:
          description: Newest-first immutable evaluation verdicts for this page.
          items:
            $ref: '#/components/schemas/ManagedAgentsEvaluation'
          type: array
        next_page_token:
          description: >-
            Signed one-hour continuation bound to the organization, filters, and
            effective limit.
          type: string
      required:
        - evaluations
      type: object
      example:
        evaluations:
          - archetype: artifact
            child_session_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d
            created_at: '2026-02-18T09:30:00.000Z'
            criteria:
              - criterion_key: example
                evidence_event_ids:
                  - 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d
                rationale: example
                verdict: pass
            evaluation_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d
            evaluator_agent_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d
            evaluator_agent_version_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d
            failure_class: none
            result: pass
            run_session_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d
            size_bucket: unknown
            snapshot_event_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d
            summary: example
            target_agent_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d
            target_agent_version_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d
            target_session_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d
        next_page_token: example
    ManagedAgentsApiErrorInvalidRequest:
      type: object
      properties:
        code:
          type: string
          minLength: 1
          description: Stable machine-readable error code.
          enum:
            - invalid_request
        message:
          type: string
          minLength: 1
          description: Human-readable error message.
        details:
          $ref: '#/components/schemas/ManagedAgentsApiErrorDetails'
          description: >-
            Optional structured error details. Reserved transport fields are
            typed; code-specific fields remain forward compatible.
      required:
        - code
        - message
      additionalProperties: false
      description: Standard flat error response.
    ManagedAgentsApiErrorUnauthorized:
      type: object
      properties:
        code:
          type: string
          minLength: 1
          description: Stable machine-readable error code.
          enum:
            - unauthorized
        message:
          type: string
          minLength: 1
          description: Human-readable error message.
        details:
          $ref: '#/components/schemas/ManagedAgentsApiErrorDetails'
          description: >-
            Optional structured error details. Reserved transport fields are
            typed; code-specific fields remain forward compatible.
      required:
        - code
        - message
      additionalProperties: false
      description: Standard flat error response.
    ManagedAgentsApiErrorForbidden:
      type: object
      properties:
        code:
          type: string
          minLength: 1
          description: Stable machine-readable error code.
          enum:
            - forbidden
        message:
          type: string
          minLength: 1
          description: Human-readable error message.
        details:
          $ref: '#/components/schemas/ManagedAgentsApiErrorDetails'
          description: >-
            Optional structured error details. Reserved transport fields are
            typed; code-specific fields remain forward compatible.
      required:
        - code
        - message
      additionalProperties: false
      description: Standard flat error response.
    ManagedAgentsApiErrorNotFound:
      type: object
      properties:
        code:
          type: string
          minLength: 1
          description: Stable machine-readable error code.
          enum:
            - not_found
        message:
          type: string
          minLength: 1
          description: Human-readable error message.
        details:
          $ref: '#/components/schemas/ManagedAgentsApiErrorDetails'
          description: >-
            Optional structured error details. Reserved transport fields are
            typed; code-specific fields remain forward compatible.
      required:
        - code
        - message
      additionalProperties: false
      description: Standard flat error response.
    ManagedAgentsApiErrorRateLimitExceeded:
      type: object
      properties:
        code:
          type: string
          minLength: 1
          description: Stable machine-readable error code.
          enum:
            - rate_limit_exceeded
        message:
          type: string
          minLength: 1
          description: Human-readable error message.
        details:
          $ref: '#/components/schemas/ManagedAgentsApiErrorDetails'
          description: >-
            Optional structured error details. Reserved transport fields are
            typed; code-specific fields remain forward compatible.
      required:
        - code
        - message
      additionalProperties: false
      description: Standard flat error response.
    ManagedAgentsApiErrorInternalError:
      type: object
      properties:
        code:
          type: string
          minLength: 1
          description: Stable machine-readable error code.
          enum:
            - internal_error
        message:
          type: string
          minLength: 1
          description: Human-readable error message.
        details:
          $ref: '#/components/schemas/ManagedAgentsApiErrorDetails'
          description: >-
            Optional structured error details. Reserved transport fields are
            typed; code-specific fields remain forward compatible.
      required:
        - code
        - message
      additionalProperties: false
      description: Standard flat error response.
    ManagedAgentsApiErrorInvariantViolation:
      type: object
      properties:
        code:
          type: string
          minLength: 1
          description: Stable machine-readable error code.
          enum:
            - invariant_violation
        message:
          type: string
          minLength: 1
          description: Human-readable error message.
        details:
          $ref: '#/components/schemas/ManagedAgentsApiErrorDetails'
          description: >-
            Optional structured error details. Reserved transport fields are
            typed; code-specific fields remain forward compatible.
      required:
        - code
        - message
      additionalProperties: false
      description: Standard flat error response.
    ManagedAgentsApiErrorBadGateway:
      type: object
      properties:
        code:
          type: string
          minLength: 1
          description: Stable machine-readable error code.
          enum:
            - bad_gateway
        message:
          type: string
          minLength: 1
          description: Human-readable error message.
        details:
          $ref: '#/components/schemas/ManagedAgentsApiErrorDetails'
          description: >-
            Optional structured error details. Reserved transport fields are
            typed; code-specific fields remain forward compatible.
      required:
        - code
        - message
      additionalProperties: false
      description: Standard flat error response.
    ManagedAgentsApiErrorManagedAgentsUnavailable:
      type: object
      properties:
        code:
          type: string
          minLength: 1
          description: Stable machine-readable error code.
          enum:
            - managed_agents_unavailable
        message:
          type: string
          minLength: 1
          description: Human-readable error message.
        details:
          $ref: '#/components/schemas/ManagedAgentsApiErrorDetails'
          description: >-
            Optional structured error details. Reserved transport fields are
            typed; code-specific fields remain forward compatible.
      required:
        - code
        - message
      additionalProperties: false
      description: Standard flat error response.
    ManagedAgentsApiErrorServiceUnavailable:
      type: object
      properties:
        code:
          type: string
          minLength: 1
          description: Stable machine-readable error code.
          enum:
            - service_unavailable
        message:
          type: string
          minLength: 1
          description: Human-readable error message.
        details:
          $ref: '#/components/schemas/ManagedAgentsApiErrorDetails'
          description: >-
            Optional structured error details. Reserved transport fields are
            typed; code-specific fields remain forward compatible.
      required:
        - code
        - message
      additionalProperties: false
      description: Standard flat error response.
    ManagedAgentsApiErrorGatewayTimeout:
      type: object
      properties:
        code:
          type: string
          minLength: 1
          description: Stable machine-readable error code.
          enum:
            - gateway_timeout
        message:
          type: string
          minLength: 1
          description: Human-readable error message.
        details:
          $ref: '#/components/schemas/ManagedAgentsApiErrorDetails'
          description: >-
            Optional structured error details. Reserved transport fields are
            typed; code-specific fields remain forward compatible.
      required:
        - code
        - message
      additionalProperties: false
      description: Standard flat error response.
    ManagedAgentsEvaluation:
      additionalProperties: false
      description: >-
        One immutable evaluator verdict over a frozen target-session transcript
        snapshot.
      properties:
        archetype:
          description: Evaluator-classified shape of the target work.
          enum:
            - artifact
            - conversation
            - critique
            - benchmark
            - automation
            - interactive
            - external
          type: string
        child_session_id:
          description: Evaluation child session that inspected this target snapshot.
          format: uuid
          type: string
        created_at:
          description: UTC timestamp when the immutable evaluation row was recorded.
          format: date-time
          type: string
        criteria:
          description: Key-sorted immutable criterion verdicts and their evidence.
          items:
            $ref: '#/components/schemas/ManagedAgentsEvaluationCriterion'
          type: array
        evaluation_id:
          description: Stable identity of this immutable evaluation snapshot.
          format: uuid
          type: string
        evaluator_agent_id:
          description: Evaluation agent that produced this verdict.
          format: uuid
          type: string
        evaluator_agent_version_id:
          description: Immutable evaluator version containing the frozen rubric.
          format: uuid
          type: string
        failure_class:
          description: Stable reason class when the overall result is not a pass.
          enum:
            - none
            - target_failed
            - target_cancelled
            - multiple_criteria
            - incomplete
            - unsupported_claim
            - unverified
            - out_of_scope
            - termination
            - criterion_failure
          type: string
        result:
          description: Overall verdict across the frozen rubric criteria.
          enum:
            - pass
            - fail
            - not_applicable
          type: string
        run_session_id:
          description: Root session that ran the evaluation.
          format: uuid
          type: string
        size_bucket:
          description: Evaluator-classified relative size of the target work.
          enum:
            - unknown
            - small
            - medium
            - large
          type: string
        snapshot_event_id:
          description: >-
            Canonical UUID transcript boundary; may be a current UUIDv7 or a
            retained legacy UUIDv4 event id.
          format: uuid
          type: string
        summary:
          description: Evaluator-authored concise explanation of the overall verdict.
          type: string
        target_agent_id:
          description: Agent attributed to the target at its first durable event.
          format: uuid
          type: string
        target_agent_version_id:
          description: Immutable target-agent version captured for the evaluation.
          format: uuid
          type: string
        target_session_id:
          description: Root session whose frozen transcript was evaluated.
          format: uuid
          type: string
      required:
        - evaluation_id
        - target_session_id
        - target_agent_id
        - target_agent_version_id
        - evaluator_agent_id
        - evaluator_agent_version_id
        - run_session_id
        - child_session_id
        - snapshot_event_id
        - result
        - summary
        - archetype
        - size_bucket
        - failure_class
        - created_at
        - criteria
      type: object
      example:
        archetype: artifact
        child_session_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d
        created_at: '2026-02-18T09:30:00.000Z'
        criteria:
          - criterion_key: example
            evidence_event_ids:
              - 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d
            rationale: example
            verdict: pass
        evaluation_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d
        evaluator_agent_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d
        evaluator_agent_version_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d
        failure_class: none
        result: pass
        run_session_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d
        size_bucket: unknown
        snapshot_event_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d
        summary: example
        target_agent_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d
        target_agent_version_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d
        target_session_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d
    ManagedAgentsApiErrorDetails:
      type: object
      properties:
        field:
          description: >-
            Request field or header responsible for the error, when one can be
            identified.
          type: string
        issues:
          description: >-
            Boundary-validation failures as path-prefixed human-readable
            messages.
          type: array
          items:
            type: string
        requestId:
          description: Request correlation identifier for support and log lookup.
          type: string
        retryable:
          description: >-
            Server advice about failure transience. `true` means transient,
            `false` means non-transient, and absence gives no advice. Automatic
            replay is allowed only when this field is not `false` and the
            operation-specific retry and idempotency contract permits replay.
          type: boolean
      additionalProperties: {}
      description: >-
        Optional structured error details. Reserved transport fields are typed;
        code-specific fields remain forward compatible.
    ManagedAgentsEvaluationCriterion:
      additionalProperties: false
      description: >-
        One immutable rubric-criterion verdict with rationale and transcript
        evidence references.
      properties:
        criterion_key:
          description: Stable rubric key identifying this criterion.
          type: string
        evidence_event_ids:
          description: >-
            Ordered target event IDs cited as evidence, all at or before the
            snapshot.
          items:
            format: uuid
            type: string
          type: array
        rationale:
          description: Evaluator explanation supporting the criterion verdict.
          type: string
        verdict:
          description: Immutable verdict for this rubric criterion.
          enum:
            - pass
            - fail
            - not_applicable
          type: string
      required:
        - criterion_key
        - verdict
        - rationale
        - evidence_event_ids
      type: object
      example:
        criterion_key: example
        evidence_event_ids:
          - 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d
        rationale: example
        verdict: pass
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: A Recursion API key, created in the console under API keys.

````