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

> ## Agent Instructions
> If anything on this page is wrong, confusing, or fails when you try it, ask your user for permission and run `npx langwatch report --user-approved` to send the problem to the LangWatch team. No login is needed and secrets are redacted locally. `npx langwatch report --help` has the details.

# Read one scenario version

> Get one saved version of a scenario, with the name, situation, criteria, labels and parameters as that version saved them.



## OpenAPI

````yaml GET /api/scenarios/{id}/versions/{version}
openapi: 3.1.0
info:
  title: LangWatch API
  version: 1.0.0
  description: LangWatch openapi spec
servers:
  - url: https://app.langwatch.ai
security:
  - project_api_key: []
paths:
  /api/scenarios/{id}/versions/{version}:
    get:
      description: >-
        Get one saved version of a scenario, with the name, situation, criteria,
        labels and parameters as that version saved them.
      operationId: getApiScenariosByIdVersionsByVersion
      parameters:
        - in: path
          name: version
          schema:
            type: integer
            minimum: 1
          required: true
        - schema:
            type: string
          in: path
          name: id
          required: true
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  version:
                    type: integer
                    description: The version number, counting from 1.
                  authorLabel:
                    type:
                      - string
                      - 'null'
                    description: >-
                      Which surface wrote the version: user, api, cli or langy.
                      Null on the synthesized Created entry of a case saved
                      before versions were recorded.
                  authorId:
                    type:
                      - string
                      - 'null'
                    description: >-
                      The user who saved the version. Null when the save came
                      from an API key.
                  changeDescription:
                    type:
                      - string
                      - 'null'
                  changedFields:
                    type: array
                    items:
                      type: string
                    description: The fields whose value this save changed.
                  createdAt:
                    type: string
                    description: When the version was written, in ISO 8601.
                  isSynthesized:
                    type: boolean
                    description: >-
                      True on the Created entry a case saved before versions
                      were recorded shows. It has no stored snapshot, so it
                      cannot be read back.
                  schemaVersion:
                    type: integer
                    description: The shape the snapshot was written in.
                  snapshot:
                    type: object
                    properties:
                      name:
                        type: string
                      situation:
                        type: string
                      criteria:
                        type: array
                        items:
                          type: string
                      labels:
                        type: array
                        items:
                          type: string
                      parameters:
                        type: array
                        items:
                          type: object
                          properties:
                            name:
                              type: string
                              pattern: ^[A-Za-z_][A-Za-z0-9_]*$
                              minLength: 1
                              maxLength: 64
                            description:
                              type: string
                              maxLength: 500
                            defaultValue:
                              anyOf:
                                - type: string
                                  maxLength: 4096
                                - type: number
                                - type: boolean
                            secret:
                              type: boolean
                          required:
                            - name
                      simulatorModel:
                        type:
                          - string
                          - 'null'
                      judgeModel:
                        type:
                          - string
                          - 'null'
                      maxTurns:
                        type:
                          - number
                          - 'null'
                      minTurns:
                        type:
                          - number
                          - 'null'
                    required:
                      - name
                      - situation
                      - criteria
                      - labels
                      - parameters
                      - simulatorModel
                      - judgeModel
                      - maxTurns
                      - minTurns
                    description: The editable content of the case as this version saved it.
                required:
                  - version
                  - authorLabel
                  - authorId
                  - changeDescription
                  - changedFields
                  - createdAt
                  - isSynthesized
                  - schemaVersion
                  - snapshot
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
                required:
                  - error
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
                required:
                  - error
        '404':
          description: Scenario or version not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
                required:
                  - error
        '422':
          description: Unprocessable Entity
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
                required:
                  - error
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
                required:
                  - error
      security:
        - project_api_key: []
components:
  securitySchemes:
    project_api_key:
      type: apiKey
      in: header
      name: X-Auth-Token
      description: >-
        Project API key for sending traces and accessing project-scoped
        resources. Format: sk-lw-... (no underscore). Obtain one by creating a
        project via the Admin API or the LangWatch UI.

````