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

# Create execution state snapshot

> Requires scopes: runs:write



## OpenAPI

````yaml /api-reference/openapi.json post /api/execution-state/sessions/{sessionId}/snapshot
openapi: 3.1.2
info:
  title: EvalGate API
  version: 5.1.0
  description: EvalGate API. See docs/api-contract.md for stability commitments.
servers:
  - url: https://evalgate.com
    description: Production
  - url: http://localhost:3000
    description: Local
security: []
paths:
  /api/execution-state/sessions/{sessionId}/snapshot:
    post:
      tags:
        - execution state
      summary: Create execution state snapshot
      description: 'Requires scopes: runs:write'
      operationId: post_execution_state_sessions_sessionId_snapshot
      parameters:
        - name: sessionId
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/PostApiExecutionStateSessionsSessionIdSnapshotRequest
      responses:
        '201':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/PostApiExecutionStateSessionsSessionIdSnapshotResponse201ApplicationJson
        '400':
          $ref: '#/components/responses/ValidationError'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '409':
          $ref: '#/components/responses/Conflict'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/InternalError'
        '503':
          $ref: '#/components/responses/ServiceUnavailable'
      security:
        - bearerAuth: []
components:
  schemas:
    PostApiExecutionStateSessionsSessionIdSnapshotRequest:
      type: object
      properties:
        expectedRevision:
          type: number
        reducerVersion:
          type: string
        throughSequence:
          type: number
      additionalProperties: false
      required:
        - expectedRevision
    PostApiExecutionStateSessionsSessionIdSnapshotResponse201ApplicationJson:
      type: object
      properties:
        status:
          oneOf:
            - type: string
              enum:
                - conflicted
            - type: string
              enum:
                - complete
            - type: string
              enum:
                - blocked
            - type: string
              enum:
                - partial
        id:
          type: string
        createdAt:
          type: string
        organizationId:
          $ref: '#/components/schemas/OrganizationId'
        permissions:
          type: object
          properties:
            policyDecisionIds:
              type: array
              items:
                type: string
            activeApprovals:
              type: array
              items:
                type: string
            deniedActions:
              type: array
              items:
                type: string
            expiredApprovals:
              type: array
              items:
                type: string
          additionalProperties: false
          required:
            - policyDecisionIds
            - activeApprovals
            - deniedActions
            - expiredApprovals
        schemaVersion:
          type: number
          enum:
            - 1
        artifacts:
          type: array
          items:
            type: object
            properties:
              status:
                oneOf:
                  - type: string
                    enum:
                      - conflicted
                  - type: string
                    enum:
                      - observed
                  - type: string
                    enum:
                      - modified
                  - type: string
                    enum:
                      - created
                  - type: string
                    enum:
                      - deleted
                  - type: string
                    enum:
                      - stale
              ref:
                type: object
                properties:
                  organizationId:
                    $ref: '#/components/schemas/OrganizationId'
                  schemaVersion:
                    type: number
                    enum:
                      - 1
                  kind:
                    oneOf:
                      - type: string
                        enum:
                          - prompt
                      - type: string
                        enum:
                          - judge_config
                      - type: string
                        enum:
                          - scorer
                      - type: string
                        enum:
                          - policy_pack
                      - type: string
                        enum:
                          - ruleset
                      - type: string
                        enum:
                          - model_routing_profile
                      - type: string
                        enum:
                          - model_binding
                      - type: string
                        enum:
                          - retrieval_corpus
                      - type: string
                        enum:
                          - retrieval_index
                      - type: string
                        enum:
                          - retrieval_config
                      - type: string
                        enum:
                          - tool_contract
                      - type: string
                        enum:
                          - tool_inventory
                      - type: string
                        enum:
                          - workflow
                      - type: string
                        enum:
                          - agent_topology
                      - type: string
                        enum:
                          - memory_entry_set
                      - type: string
                        enum:
                          - skill
                      - type: string
                        enum:
                          - runtime_config
                      - type: string
                        enum:
                          - dataset
                      - type: string
                        enum:
                          - evaluation
                      - type: string
                        enum:
                          - repository_commit
                      - type: string
                        enum:
                          - agent_task
                      - type: string
                        enum:
                          - task_environment
                      - type: string
                        enum:
                          - task_verifier
                      - type: string
                        enum:
                          - harness_profile
                      - type: string
                        enum:
                          - context_policy
                      - type: string
                        enum:
                          - execution_state_schema
                      - type: string
                        enum:
                          - orchestration_program
                      - type: string
                        enum:
                          - subagent_profile
                      - type: string
                        enum:
                          - eval_catalog
                      - type: string
                        enum:
                          - experiment_plan
                      - type: string
                        enum:
                          - tool_policy
                      - type: string
                        enum:
                          - mcp_config
                      - type: string
                        enum:
                          - memory_policy
                      - type: string
                        enum:
                          - prompt_overlay
                      - type: string
                        enum:
                          - release_constraint
                  artifactId:
                    type: string
                  versionId:
                    type: string
                  contentHash:
                    type: string
                  environment:
                    oneOf:
                      - type: string
                        enum:
                          - local
                      - type: string
                        enum:
                          - ci
                      - type: string
                        enum:
                          - dev
                      - type: string
                        enum:
                          - staging
                      - type: string
                        enum:
                          - prod
                  sourceControl:
                    type: object
                    properties:
                      repositoryId:
                        type: string
                      provider:
                        oneOf:
                          - type: string
                            enum:
                              - github
                          - type: string
                            enum:
                              - gitlab
                          - type: string
                            enum:
                              - bitbucket
                          - type: string
                            enum:
                              - azure_devops
                          - type: string
                            enum:
                              - other
                      commitSha:
                        type: string
                      path:
                        type: string
                    additionalProperties: false
                    required:
                      - repositoryId
                      - provider
                      - commitSha
                  dependencySnapshotHash:
                    type: string
                additionalProperties: false
                required:
                  - organizationId
                  - schemaVersion
                  - kind
                  - artifactId
                  - versionId
                  - contentHash
              role:
                oneOf:
                  - type: string
                    enum:
                      - input
                  - type: string
                    enum:
                      - rollback
                  - type: string
                    enum:
                      - evidence
                  - type: string
                    enum:
                      - output
                  - type: string
                    enum:
                      - working
                  - type: string
                    enum:
                      - constraint
              sourceEventIds:
                type: array
                items:
                  type: string
            additionalProperties: false
            required:
              - status
              - ref
              - role
              - sourceEventIds
        contentHash:
          type: string
        revision:
          type: number
        reasonCodes:
          type: array
          items:
            type: string
        evidence:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              organizationId:
                $ref: '#/components/schemas/OrganizationId'
              schemaVersion:
                type: number
                enum:
                  - 1
              kind:
                oneOf:
                  - type: string
                    enum:
                      - trace_revision
                  - type: string
                    enum:
                      - trajectory
                  - type: string
                    enum:
                      - evidence_item
                  - type: string
                    enum:
                      - evaluation_run
                  - type: string
                    enum:
                      - test_result
                  - type: string
                    enum:
                      - measurement_revision
                  - type: string
                    enum:
                      - evaluator_release
                  - type: string
                    enum:
                      - repair_decision
                  - type: string
                    enum:
                      - experiment_decision
                  - type: string
                    enum:
                      - objective_decision
                  - type: string
                    enum:
                      - release_plan
                  - type: string
                    enum:
                      - release_decision
                  - type: string
                    enum:
                      - production_outcome
                  - type: string
                    enum:
                      - human_adjudication
                  - type: string
                    enum:
                      - privacy_manifest
                  - type: string
                    enum:
                      - task_environment_snapshot
                  - type: string
                    enum:
                      - task_attempt
                  - type: string
                    enum:
                      - state_delta
                  - type: string
                    enum:
                      - context_epoch
                  - type: string
                    enum:
                      - compaction_event
                  - type: string
                    enum:
                      - model_handoff
                  - type: string
                    enum:
                      - memory_decision
                  - type: string
                    enum:
                      - orchestration_dispatch
                  - type: string
                    enum:
                      - subagent_run
                  - type: string
                    enum:
                      - trial_batch
                  - type: string
                    enum:
                      - harness_comparison
              contentHash:
                type: string
              occurredAt:
                type: string
              privacyManifestId:
                type: string
              privacyViewId:
                type: string
            additionalProperties: false
            required:
              - id
              - organizationId
              - schemaVersion
              - kind
              - contentHash
              - occurredAt
        objective:
          type: object
          properties:
            status:
              oneOf:
                - type: string
                  enum:
                    - active
                - type: string
                  enum:
                    - completed
                - type: string
                  enum:
                    - paused
                - type: string
                  enum:
                    - blocked
                - type: string
                  enum:
                    - none
            summary:
              type: string
            hardConstraints:
              type: array
              items:
                type: string
            successCriteria:
              type: array
              items:
                type: string
            objectiveVersionId:
              type: string
            objectiveId:
              type: string
            objectiveInstanceId:
              type: string
          additionalProperties: false
          required:
            - status
            - summary
            - hardConstraints
            - successCriteria
        sessionId:
          type: string
        context:
          type: object
          properties:
            completeness:
              oneOf:
                - type: string
                  enum:
                    - complete
                - type: string
                  enum:
                    - blocked
                - type: string
                  enum:
                    - partial
            activeEpochId:
              type: string
            offloadedRefs:
              type: array
              items:
                type: string
            omittedRequiredRefs:
              type: array
              items:
                type: string
          additionalProperties: false
          required:
            - completeness
            - activeEpochId
            - offloadedRefs
            - omittedRequiredRefs
        failures:
          type: object
          properties:
            unresolvedFailureIds:
              type: array
              items:
                type: string
            resolvedFailureIds:
              type: array
              items:
                type: string
            rejectedApproachIds:
              type: array
              items:
                type: string
          additionalProperties: false
          required:
            - unresolvedFailureIds
            - resolvedFailureIds
            - rejectedApproachIds
        reducedThroughSequence:
          type: number
        reducerVersion:
          type: string
        sourceEventSetHash:
          type: string
        work:
          type: object
          properties:
            pending:
              type: array
              items:
                type: object
                properties:
                  status:
                    oneOf:
                      - type: string
                        enum:
                          - pending
                      - type: string
                        enum:
                          - active
                      - type: string
                        enum:
                          - completed
                      - type: string
                        enum:
                          - blocked
                  id:
                    type: string
                  title:
                    type: string
                  sourceEventIds:
                    type: array
                    items:
                      type: string
                  evidenceRefs:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        organizationId:
                          $ref: '#/components/schemas/OrganizationId'
                        schemaVersion:
                          type: number
                          enum:
                            - 1
                        kind:
                          oneOf:
                            - type: string
                              enum:
                                - trace_revision
                            - type: string
                              enum:
                                - trajectory
                            - type: string
                              enum:
                                - evidence_item
                            - type: string
                              enum:
                                - evaluation_run
                            - type: string
                              enum:
                                - test_result
                            - type: string
                              enum:
                                - measurement_revision
                            - type: string
                              enum:
                                - evaluator_release
                            - type: string
                              enum:
                                - repair_decision
                            - type: string
                              enum:
                                - experiment_decision
                            - type: string
                              enum:
                                - objective_decision
                            - type: string
                              enum:
                                - release_plan
                            - type: string
                              enum:
                                - release_decision
                            - type: string
                              enum:
                                - production_outcome
                            - type: string
                              enum:
                                - human_adjudication
                            - type: string
                              enum:
                                - privacy_manifest
                            - type: string
                              enum:
                                - task_environment_snapshot
                            - type: string
                              enum:
                                - task_attempt
                            - type: string
                              enum:
                                - state_delta
                            - type: string
                              enum:
                                - context_epoch
                            - type: string
                              enum:
                                - compaction_event
                            - type: string
                              enum:
                                - model_handoff
                            - type: string
                              enum:
                                - memory_decision
                            - type: string
                              enum:
                                - orchestration_dispatch
                            - type: string
                              enum:
                                - subagent_run
                            - type: string
                              enum:
                                - trial_batch
                            - type: string
                              enum:
                                - harness_comparison
                        contentHash:
                          type: string
                        occurredAt:
                          type: string
                        privacyManifestId:
                          type: string
                        privacyViewId:
                          type: string
                      additionalProperties: false
                      required:
                        - id
                        - organizationId
                        - schemaVersion
                        - kind
                        - contentHash
                        - occurredAt
                  owner:
                    type: string
                additionalProperties: false
                required:
                  - status
                  - id
                  - title
                  - sourceEventIds
                  - evidenceRefs
            active:
              type: array
              items:
                type: object
                properties:
                  status:
                    oneOf:
                      - type: string
                        enum:
                          - pending
                      - type: string
                        enum:
                          - active
                      - type: string
                        enum:
                          - completed
                      - type: string
                        enum:
                          - blocked
                  id:
                    type: string
                  title:
                    type: string
                  sourceEventIds:
                    type: array
                    items:
                      type: string
                  evidenceRefs:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        organizationId:
                          $ref: '#/components/schemas/OrganizationId'
                        schemaVersion:
                          type: number
                          enum:
                            - 1
                        kind:
                          oneOf:
                            - type: string
                              enum:
                                - trace_revision
                            - type: string
                              enum:
                                - trajectory
                            - type: string
                              enum:
                                - evidence_item
                            - type: string
                              enum:
                                - evaluation_run
                            - type: string
                              enum:
                                - test_result
                            - type: string
                              enum:
                                - measurement_revision
                            - type: string
                              enum:
                                - evaluator_release
                            - type: string
                              enum:
                                - repair_decision
                            - type: string
                              enum:
                                - experiment_decision
                            - type: string
                              enum:
                                - objective_decision
                            - type: string
                              enum:
                                - release_plan
                            - type: string
                              enum:
                                - release_decision
                            - type: string
                              enum:
                                - production_outcome
                            - type: string
                              enum:
                                - human_adjudication
                            - type: string
                              enum:
                                - privacy_manifest
                            - type: string
                              enum:
                                - task_environment_snapshot
                            - type: string
                              enum:
                                - task_attempt
                            - type: string
                              enum:
                                - state_delta
                            - type: string
                              enum:
                                - context_epoch
                            - type: string
                              enum:
                                - compaction_event
                            - type: string
                              enum:
                                - model_handoff
                            - type: string
                              enum:
                                - memory_decision
                            - type: string
                              enum:
                                - orchestration_dispatch
                            - type: string
                              enum:
                                - subagent_run
                            - type: string
                              enum:
                                - trial_batch
                            - type: string
                              enum:
                                - harness_comparison
                        contentHash:
                          type: string
                        occurredAt:
                          type: string
                        privacyManifestId:
                          type: string
                        privacyViewId:
                          type: string
                      additionalProperties: false
                      required:
                        - id
                        - organizationId
                        - schemaVersion
                        - kind
                        - contentHash
                        - occurredAt
                  owner:
                    type: string
                additionalProperties: false
                required:
                  - status
                  - id
                  - title
                  - sourceEventIds
                  - evidenceRefs
            completed:
              type: array
              items:
                type: object
                properties:
                  status:
                    oneOf:
                      - type: string
                        enum:
                          - pending
                      - type: string
                        enum:
                          - active
                      - type: string
                        enum:
                          - completed
                      - type: string
                        enum:
                          - blocked
                  id:
                    type: string
                  title:
                    type: string
                  sourceEventIds:
                    type: array
                    items:
                      type: string
                  evidenceRefs:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        organizationId:
                          $ref: '#/components/schemas/OrganizationId'
                        schemaVersion:
                          type: number
                          enum:
                            - 1
                        kind:
                          oneOf:
                            - type: string
                              enum:
                                - trace_revision
                            - type: string
                              enum:
                                - trajectory
                            - type: string
                              enum:
                                - evidence_item
                            - type: string
                              enum:
                                - evaluation_run
                            - type: string
                              enum:
                                - test_result
                            - type: string
                              enum:
                                - measurement_revision
                            - type: string
                              enum:
                                - evaluator_release
                            - type: string
                              enum:
                                - repair_decision
                            - type: string
                              enum:
                                - experiment_decision
                            - type: string
                              enum:
                                - objective_decision
                            - type: string
                              enum:
                                - release_plan
                            - type: string
                              enum:
                                - release_decision
                            - type: string
                              enum:
                                - production_outcome
                            - type: string
                              enum:
                                - human_adjudication
                            - type: string
                              enum:
                                - privacy_manifest
                            - type: string
                              enum:
                                - task_environment_snapshot
                            - type: string
                              enum:
                                - task_attempt
                            - type: string
                              enum:
                                - state_delta
                            - type: string
                              enum:
                                - context_epoch
                            - type: string
                              enum:
                                - compaction_event
                            - type: string
                              enum:
                                - model_handoff
                            - type: string
                              enum:
                                - memory_decision
                            - type: string
                              enum:
                                - orchestration_dispatch
                            - type: string
                              enum:
                                - subagent_run
                            - type: string
                              enum:
                                - trial_batch
                            - type: string
                              enum:
                                - harness_comparison
                        contentHash:
                          type: string
                        occurredAt:
                          type: string
                        privacyManifestId:
                          type: string
                        privacyViewId:
                          type: string
                      additionalProperties: false
                      required:
                        - id
                        - organizationId
                        - schemaVersion
                        - kind
                        - contentHash
                        - occurredAt
                  owner:
                    type: string
                additionalProperties: false
                required:
                  - status
                  - id
                  - title
                  - sourceEventIds
                  - evidenceRefs
            blocked:
              type: array
              items:
                type: object
                properties:
                  status:
                    oneOf:
                      - type: string
                        enum:
                          - pending
                      - type: string
                        enum:
                          - active
                      - type: string
                        enum:
                          - completed
                      - type: string
                        enum:
                          - blocked
                  id:
                    type: string
                  title:
                    type: string
                  sourceEventIds:
                    type: array
                    items:
                      type: string
                  evidenceRefs:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        organizationId:
                          $ref: '#/components/schemas/OrganizationId'
                        schemaVersion:
                          type: number
                          enum:
                            - 1
                        kind:
                          oneOf:
                            - type: string
                              enum:
                                - trace_revision
                            - type: string
                              enum:
                                - trajectory
                            - type: string
                              enum:
                                - evidence_item
                            - type: string
                              enum:
                                - evaluation_run
                            - type: string
                              enum:
                                - test_result
                            - type: string
                              enum:
                                - measurement_revision
                            - type: string
                              enum:
                                - evaluator_release
                            - type: string
                              enum:
                                - repair_decision
                            - type: string
                              enum:
                                - experiment_decision
                            - type: string
                              enum:
                                - objective_decision
                            - type: string
                              enum:
                                - release_plan
                            - type: string
                              enum:
                                - release_decision
                            - type: string
                              enum:
                                - production_outcome
                            - type: string
                              enum:
                                - human_adjudication
                            - type: string
                              enum:
                                - privacy_manifest
                            - type: string
                              enum:
                                - task_environment_snapshot
                            - type: string
                              enum:
                                - task_attempt
                            - type: string
                              enum:
                                - state_delta
                            - type: string
                              enum:
                                - context_epoch
                            - type: string
                              enum:
                                - compaction_event
                            - type: string
                              enum:
                                - model_handoff
                            - type: string
                              enum:
                                - memory_decision
                            - type: string
                              enum:
                                - orchestration_dispatch
                            - type: string
                              enum:
                                - subagent_run
                            - type: string
                              enum:
                                - trial_batch
                            - type: string
                              enum:
                                - harness_comparison
                        contentHash:
                          type: string
                        occurredAt:
                          type: string
                        privacyManifestId:
                          type: string
                        privacyViewId:
                          type: string
                      additionalProperties: false
                      required:
                        - id
                        - organizationId
                        - schemaVersion
                        - kind
                        - contentHash
                        - occurredAt
                  owner:
                    type: string
                additionalProperties: false
                required:
                  - status
                  - id
                  - title
                  - sourceEventIds
                  - evidenceRefs
          additionalProperties: false
          required:
            - pending
            - active
            - completed
            - blocked
        decisions:
          type: object
          properties:
            rejected:
              type: array
              items:
                type: object
                properties:
                  status:
                    oneOf:
                      - type: string
                        enum:
                          - rejected
                      - type: string
                        enum:
                          - accepted
                      - type: string
                        enum:
                          - superseded
                      - type: string
                        enum:
                          - unresolved
                  id:
                    type: string
                  scope:
                    type: string
                  sourceEventIds:
                    type: array
                    items:
                      type: string
                  evidenceRefs:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        organizationId:
                          $ref: '#/components/schemas/OrganizationId'
                        schemaVersion:
                          type: number
                          enum:
                            - 1
                        kind:
                          oneOf:
                            - type: string
                              enum:
                                - trace_revision
                            - type: string
                              enum:
                                - trajectory
                            - type: string
                              enum:
                                - evidence_item
                            - type: string
                              enum:
                                - evaluation_run
                            - type: string
                              enum:
                                - test_result
                            - type: string
                              enum:
                                - measurement_revision
                            - type: string
                              enum:
                                - evaluator_release
                            - type: string
                              enum:
                                - repair_decision
                            - type: string
                              enum:
                                - experiment_decision
                            - type: string
                              enum:
                                - objective_decision
                            - type: string
                              enum:
                                - release_plan
                            - type: string
                              enum:
                                - release_decision
                            - type: string
                              enum:
                                - production_outcome
                            - type: string
                              enum:
                                - human_adjudication
                            - type: string
                              enum:
                                - privacy_manifest
                            - type: string
                              enum:
                                - task_environment_snapshot
                            - type: string
                              enum:
                                - task_attempt
                            - type: string
                              enum:
                                - state_delta
                            - type: string
                              enum:
                                - context_epoch
                            - type: string
                              enum:
                                - compaction_event
                            - type: string
                              enum:
                                - model_handoff
                            - type: string
                              enum:
                                - memory_decision
                            - type: string
                              enum:
                                - orchestration_dispatch
                            - type: string
                              enum:
                                - subagent_run
                            - type: string
                              enum:
                                - trial_batch
                            - type: string
                              enum:
                                - harness_comparison
                        contentHash:
                          type: string
                        occurredAt:
                          type: string
                        privacyManifestId:
                          type: string
                        privacyViewId:
                          type: string
                      additionalProperties: false
                      required:
                        - id
                        - organizationId
                        - schemaVersion
                        - kind
                        - contentHash
                        - occurredAt
                  statement:
                    type: string
                  rationale:
                    type: string
                additionalProperties: false
                required:
                  - status
                  - id
                  - scope
                  - sourceEventIds
                  - evidenceRefs
                  - statement
            accepted:
              type: array
              items:
                type: object
                properties:
                  status:
                    oneOf:
                      - type: string
                        enum:
                          - rejected
                      - type: string
                        enum:
                          - accepted
                      - type: string
                        enum:
                          - superseded
                      - type: string
                        enum:
                          - unresolved
                  id:
                    type: string
                  scope:
                    type: string
                  sourceEventIds:
                    type: array
                    items:
                      type: string
                  evidenceRefs:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        organizationId:
                          $ref: '#/components/schemas/OrganizationId'
                        schemaVersion:
                          type: number
                          enum:
                            - 1
                        kind:
                          oneOf:
                            - type: string
                              enum:
                                - trace_revision
                            - type: string
                              enum:
                                - trajectory
                            - type: string
                              enum:
                                - evidence_item
                            - type: string
                              enum:
                                - evaluation_run
                            - type: string
                              enum:
                                - test_result
                            - type: string
                              enum:
                                - measurement_revision
                            - type: string
                              enum:
                                - evaluator_release
                            - type: string
                              enum:
                                - repair_decision
                            - type: string
                              enum:
                                - experiment_decision
                            - type: string
                              enum:
                                - objective_decision
                            - type: string
                              enum:
                                - release_plan
                            - type: string
                              enum:
                                - release_decision
                            - type: string
                              enum:
                                - production_outcome
                            - type: string
                              enum:
                                - human_adjudication
                            - type: string
                              enum:
                                - privacy_manifest
                            - type: string
                              enum:
                                - task_environment_snapshot
                            - type: string
                              enum:
                                - task_attempt
                            - type: string
                              enum:
                                - state_delta
                            - type: string
                              enum:
                                - context_epoch
                            - type: string
                              enum:
                                - compaction_event
                            - type: string
                              enum:
                                - model_handoff
                            - type: string
                              enum:
                                - memory_decision
                            - type: string
                              enum:
                                - orchestration_dispatch
                            - type: string
                              enum:
                                - subagent_run
                            - type: string
                              enum:
                                - trial_batch
                            - type: string
                              enum:
                                - harness_comparison
                        contentHash:
                          type: string
                        occurredAt:
                          type: string
                        privacyManifestId:
                          type: string
                        privacyViewId:
                          type: string
                      additionalProperties: false
                      required:
                        - id
                        - organizationId
                        - schemaVersion
                        - kind
                        - contentHash
                        - occurredAt
                  statement:
                    type: string
                  rationale:
                    type: string
                additionalProperties: false
                required:
                  - status
                  - id
                  - scope
                  - sourceEventIds
                  - evidenceRefs
                  - statement
            superseded:
              type: array
              items:
                type: object
                properties:
                  status:
                    oneOf:
                      - type: string
                        enum:
                          - rejected
                      - type: string
                        enum:
                          - accepted
                      - type: string
                        enum:
                          - superseded
                      - type: string
                        enum:
                          - unresolved
                  id:
                    type: string
                  scope:
                    type: string
                  sourceEventIds:
                    type: array
                    items:
                      type: string
                  evidenceRefs:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        organizationId:
                          $ref: '#/components/schemas/OrganizationId'
                        schemaVersion:
                          type: number
                          enum:
                            - 1
                        kind:
                          oneOf:
                            - type: string
                              enum:
                                - trace_revision
                            - type: string
                              enum:
                                - trajectory
                            - type: string
                              enum:
                                - evidence_item
                            - type: string
                              enum:
                                - evaluation_run
                            - type: string
                              enum:
                                - test_result
                            - type: string
                              enum:
                                - measurement_revision
                            - type: string
                              enum:
                                - evaluator_release
                            - type: string
                              enum:
                                - repair_decision
                            - type: string
                              enum:
                                - experiment_decision
                            - type: string
                              enum:
                                - objective_decision
                            - type: string
                              enum:
                                - release_plan
                            - type: string
                              enum:
                                - release_decision
                            - type: string
                              enum:
                                - production_outcome
                            - type: string
                              enum:
                                - human_adjudication
                            - type: string
                              enum:
                                - privacy_manifest
                            - type: string
                              enum:
                                - task_environment_snapshot
                            - type: string
                              enum:
                                - task_attempt
                            - type: string
                              enum:
                                - state_delta
                            - type: string
                              enum:
                                - context_epoch
                            - type: string
                              enum:
                                - compaction_event
                            - type: string
                              enum:
                                - model_handoff
                            - type: string
                              enum:
                                - memory_decision
                            - type: string
                              enum:
                                - orchestration_dispatch
                            - type: string
                              enum:
                                - subagent_run
                            - type: string
                              enum:
                                - trial_batch
                            - type: string
                              enum:
                                - harness_comparison
                        contentHash:
                          type: string
                        occurredAt:
                          type: string
                        privacyManifestId:
                          type: string
                        privacyViewId:
                          type: string
                      additionalProperties: false
                      required:
                        - id
                        - organizationId
                        - schemaVersion
                        - kind
                        - contentHash
                        - occurredAt
                  statement:
                    type: string
                  rationale:
                    type: string
                additionalProperties: false
                required:
                  - status
                  - id
                  - scope
                  - sourceEventIds
                  - evidenceRefs
                  - statement
            unresolved:
              type: array
              items:
                type: object
                properties:
                  status:
                    oneOf:
                      - type: string
                        enum:
                          - rejected
                      - type: string
                        enum:
                          - accepted
                      - type: string
                        enum:
                          - superseded
                      - type: string
                        enum:
                          - unresolved
                  id:
                    type: string
                  scope:
                    type: string
                  sourceEventIds:
                    type: array
                    items:
                      type: string
                  evidenceRefs:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        organizationId:
                          $ref: '#/components/schemas/OrganizationId'
                        schemaVersion:
                          type: number
                          enum:
                            - 1
                        kind:
                          oneOf:
                            - type: string
                              enum:
                                - trace_revision
                            - type: string
                              enum:
                                - trajectory
                            - type: string
                              enum:
                                - evidence_item
                            - type: string
                              enum:
                                - evaluation_run
                            - type: string
                              enum:
                                - test_result
                            - type: string
                              enum:
                                - measurement_revision
                            - type: string
                              enum:
                                - evaluator_release
                            - type: string
                              enum:
                                - repair_decision
                            - type: string
                              enum:
                                - experiment_decision
                            - type: string
                              enum:
                                - objective_decision
                            - type: string
                              enum:
                                - release_plan
                            - type: string
                              enum:
                                - release_decision
                            - type: string
                              enum:
                                - production_outcome
                            - type: string
                              enum:
                                - human_adjudication
                            - type: string
                              enum:
                                - privacy_manifest
                            - type: string
                              enum:
                                - task_environment_snapshot
                            - type: string
                              enum:
                                - task_attempt
                            - type: string
                              enum:
                                - state_delta
                            - type: string
                              enum:
                                - context_epoch
                            - type: string
                              enum:
                                - compaction_event
                            - type: string
                              enum:
                                - model_handoff
                            - type: string
                              enum:
                                - memory_decision
                            - type: string
                              enum:
                                - orchestration_dispatch
                            - type: string
                              enum:
                                - subagent_run
                            - type: string
                              enum:
                                - trial_batch
                            - type: string
                              enum:
                                - harness_comparison
                        contentHash:
                          type: string
                        occurredAt:
                          type: string
                        privacyManifestId:
                          type: string
                        privacyViewId:
                          type: string
                      additionalProperties: false
                      required:
                        - id
                        - organizationId
                        - schemaVersion
                        - kind
                        - contentHash
                        - occurredAt
                  statement:
                    type: string
                  rationale:
                    type: string
                additionalProperties: false
                required:
                  - status
                  - id
                  - scope
                  - sourceEventIds
                  - evidenceRefs
                  - statement
          additionalProperties: false
          required:
            - rejected
            - accepted
            - superseded
            - unresolved
        memory:
          type: object
          properties:
            activeLocalFacts:
              type: array
              items:
                type: object
                properties:
                  id:
                    type: string
                  scope:
                    oneOf:
                      - type: string
                        enum:
                          - session
                      - type: string
                        enum:
                          - work_item
                  evidenceRefs:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        organizationId:
                          $ref: '#/components/schemas/OrganizationId'
                        schemaVersion:
                          type: number
                          enum:
                            - 1
                        kind:
                          oneOf:
                            - type: string
                              enum:
                                - trace_revision
                            - type: string
                              enum:
                                - trajectory
                            - type: string
                              enum:
                                - evidence_item
                            - type: string
                              enum:
                                - evaluation_run
                            - type: string
                              enum:
                                - test_result
                            - type: string
                              enum:
                                - measurement_revision
                            - type: string
                              enum:
                                - evaluator_release
                            - type: string
                              enum:
                                - repair_decision
                            - type: string
                              enum:
                                - experiment_decision
                            - type: string
                              enum:
                                - objective_decision
                            - type: string
                              enum:
                                - release_plan
                            - type: string
                              enum:
                                - release_decision
                            - type: string
                              enum:
                                - production_outcome
                            - type: string
                              enum:
                                - human_adjudication
                            - type: string
                              enum:
                                - privacy_manifest
                            - type: string
                              enum:
                                - task_environment_snapshot
                            - type: string
                              enum:
                                - task_attempt
                            - type: string
                              enum:
                                - state_delta
                            - type: string
                              enum:
                                - context_epoch
                            - type: string
                              enum:
                                - compaction_event
                            - type: string
                              enum:
                                - model_handoff
                            - type: string
                              enum:
                                - memory_decision
                            - type: string
                              enum:
                                - orchestration_dispatch
                            - type: string
                              enum:
                                - subagent_run
                            - type: string
                              enum:
                                - trial_batch
                            - type: string
                              enum:
                                - harness_comparison
                        contentHash:
                          type: string
                        occurredAt:
                          type: string
                        privacyManifestId:
                          type: string
                        privacyViewId:
                          type: string
                      additionalProperties: false
                      required:
                        - id
                        - organizationId
                        - schemaVersion
                        - kind
                        - contentHash
                        - occurredAt
                  statement:
                    type: string
                  trust:
                    oneOf:
                      - type: string
                        enum:
                          - observed
                      - type: string
                        enum:
                          - verified
                      - type: string
                        enum:
                          - inferred
                  expiresAt:
                    type: string
                additionalProperties: false
                required:
                  - id
                  - scope
                  - evidenceRefs
                  - statement
                  - trust
            pendingCandidates:
              type: array
              items:
                type: string
            rejectedCandidates:
              type: array
              items:
                type: string
          additionalProperties: false
          required:
            - activeLocalFacts
            - pendingCandidates
            - rejectedCandidates
        next:
          type: object
          properties:
            recommendedActions:
              type: array
              items:
                type: object
                properties:
                  id:
                    type: string
                  rationale:
                    type: string
                  action:
                    type: string
                  authority:
                    oneOf:
                      - type: string
                        enum:
                          - read_only
                      - type: string
                        enum:
                          - requires_approval
                      - type: string
                        enum:
                          - preauthorized
                  targetRef:
                    type: object
                    properties:
                      organizationId:
                        $ref: '#/components/schemas/OrganizationId'
                      schemaVersion:
                        type: number
                        enum:
                          - 1
                      kind:
                        oneOf:
                          - type: string
                            enum:
                              - prompt
                          - type: string
                            enum:
                              - judge_config
                          - type: string
                            enum:
                              - scorer
                          - type: string
                            enum:
                              - policy_pack
                          - type: string
                            enum:
                              - ruleset
                          - type: string
                            enum:
                              - model_routing_profile
                          - type: string
                            enum:
                              - model_binding
                          - type: string
                            enum:
                              - retrieval_corpus
                          - type: string
                            enum:
                              - retrieval_index
                          - type: string
                            enum:
                              - retrieval_config
                          - type: string
                            enum:
                              - tool_contract
                          - type: string
                            enum:
                              - tool_inventory
                          - type: string
                            enum:
                              - workflow
                          - type: string
                            enum:
                              - agent_topology
                          - type: string
                            enum:
                              - memory_entry_set
                          - type: string
                            enum:
                              - skill
                          - type: string
                            enum:
                              - runtime_config
                          - type: string
                            enum:
                              - dataset
                          - type: string
                            enum:
                              - evaluation
                          - type: string
                            enum:
                              - repository_commit
                          - type: string
                            enum:
                              - agent_task
                          - type: string
                            enum:
                              - task_environment
                          - type: string
                            enum:
                              - task_verifier
                          - type: string
                            enum:
                              - harness_profile
                          - type: string
                            enum:
                              - context_policy
                          - type: string
                            enum:
                              - execution_state_schema
                          - type: string
                            enum:
                              - orchestration_program
                          - type: string
                            enum:
                              - subagent_profile
                          - type: string
                            enum:
                              - eval_catalog
                          - type: string
                            enum:
                              - experiment_plan
                          - type: string
                            enum:
                              - tool_policy
                          - type: string
                            enum:
                              - mcp_config
                          - type: string
                            enum:
                              - memory_policy
                          - type: string
                            enum:
                              - prompt_overlay
                          - type: string
                            enum:
                              - release_constraint
                      artifactId:
                        type: string
                      versionId:
                        type: string
                      contentHash:
                        type: string
                      environment:
                        oneOf:
                          - type: string
                            enum:
                              - local
                          - type: string
                            enum:
                              - ci
                          - type: string
                            enum:
                              - dev
                          - type: string
                            enum:
                              - staging
                          - type: string
                            enum:
                              - prod
                      sourceControl:
                        type: object
                        properties:
                          repositoryId:
                            type: string
                          provider:
                            oneOf:
                              - type: string
                                enum:
                                  - github
                              - type: string
                                enum:
                                  - gitlab
                              - type: string
                                enum:
                                  - bitbucket
                              - type: string
                                enum:
                                  - azure_devops
                              - type: string
                                enum:
                                  - other
                          commitSha:
                            type: string
                          path:
                            type: string
                        additionalProperties: false
                        required:
                          - repositoryId
                          - provider
                          - commitSha
                      dependencySnapshotHash:
                        type: string
                    additionalProperties: false
                    required:
                      - organizationId
                      - schemaVersion
                      - kind
                      - artifactId
                      - versionId
                      - contentHash
                additionalProperties: false
                required:
                  - id
                  - rationale
                  - action
                  - authority
            openQuestions:
              type: array
              items:
                type: object
                properties:
                  id:
                    type: string
                  question:
                    type: string
                  blocking:
                    type: boolean
                  requiredEvidence:
                    type: array
                    items:
                      type: string
                additionalProperties: false
                required:
                  - id
                  - question
                  - blocking
                  - requiredEvidence
            verificationRequired:
              type: array
              items:
                type: object
                properties:
                  id:
                    type: string
                  statement:
                    type: string
                  requiredBefore:
                    oneOf:
                      - type: string
                        enum:
                          - release
                      - type: string
                        enum:
                          - next_model_call
                      - type: string
                        enum:
                          - tool_use
                      - type: string
                        enum:
                          - mutation
                      - type: string
                        enum:
                          - publication
                additionalProperties: false
                required:
                  - id
                  - statement
                  - requiredBefore
          additionalProperties: false
          required:
            - recommendedActions
            - openQuestions
            - verificationRequired
      additionalProperties: false
      required:
        - status
        - id
        - createdAt
        - organizationId
        - permissions
        - schemaVersion
        - artifacts
        - contentHash
        - revision
        - reasonCodes
        - evidence
        - objective
        - sessionId
        - context
        - failures
        - reducedThroughSequence
        - reducerVersion
        - sourceEventSetHash
        - work
        - decisions
        - memory
        - next
    OrganizationId:
      type: string
      format: uuid
    ApiError:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - UNAUTHORIZED
                - FORBIDDEN
                - NOT_FOUND
                - INVALID_REFERENCE
                - VALIDATION_ERROR
                - RATE_LIMITED
                - CONFLICT
                - INTERNAL_ERROR
                - SERVICE_UNAVAILABLE
                - QUOTA_EXCEEDED
                - FEATURE_LIMIT_REACHED
                - NO_ORG_MEMBERSHIP
                - SHARE_REVOKED
                - SHARE_EXPIRED
                - SHARE_UNAVAILABLE
                - PROVIDER_KEY_MISSING
                - PROVIDER_KEY_EXPIRED
                - PROVIDER_RATE_LIMITED
                - PROVIDER_UNAUTHORIZED
                - PROVIDER_UNAVAILABLE
                - AGENT_HANDOFF_INVALID
                - AGENT_HANDOFF_EXPIRED
                - AGENT_HANDOFF_DENIED
                - AGENT_HANDOFF_CONSUMED
                - PAYLOAD_TOO_LARGE
                - METHOD_NOT_ALLOWED
            message:
              type: string
            details: {}
            requestId:
              type: string
              format: uuid
            redaction:
              type: object
              properties:
                applied:
                  type: boolean
                  enum:
                    - true
                fieldCount:
                  type: integer
                  minimum: 0
                secretCount:
                  type: integer
                  minimum: 0
              required:
                - applied
                - fieldCount
                - secretCount
          required:
            - code
            - message
      required:
        - error
  responses:
    ValidationError:
      description: Validation error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    Unauthorized:
      description: Unauthorized
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
      headers:
        WWW-Authenticate:
          description: >-
            Bearer challenge. Agent-facing routes include the RFC 9728
            resource_metadata URL.
          schema:
            type: string
    Forbidden:
      description: Forbidden
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    NotFound:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    Conflict:
      description: Conflict
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    RateLimited:
      description: Rate limit exceeded
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
      headers:
        Retry-After:
          description: Delay in seconds before retrying when present.
          schema:
            type: integer
            minimum: 1
        RateLimit-Policy:
          description: IETF HTTPAPI structured quota policy (work in progress).
          schema:
            type: string
        RateLimit:
          description: >-
            IETF HTTPAPI structured remaining quota and reset delay (work in
            progress).
          schema:
            type: string
    InternalError:
      description: Internal server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    ServiceUnavailable:
      description: Service unavailable
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: EvalGate API key
      description: >-
        Organization-scoped EvalGate API key. Discover the supported agent
        scopes at /.well-known/oauth-protected-resource. Per-operation grants
        are listed in x-evalgate-required-scopes; OpenAPI bearer security
        requirement arrays remain empty as required for non-OAuth schemes.
      x-evalgate-scopes-supported:
        - eval:read
        - eval:write
        - objectives:read
        - objectives:write
        - runs:read
        - runs:write
        - traces:read
        - traces:write
        - exports:download
        - reports:write
        - prompt:publish
        - scorer:publish
        - red_team:read
        - red_team:run
        - red_team:approve
        - docs:read
        - agent:read
        - agent:execute
        - admin:keys
        - admin:org
      x-evalgate-protected-resource-metadata: https://www.evalgate.com/.well-known/oauth-protected-resource

````