> ## 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.

# List a scenario's versions

> List the saved versions of a scenario, newest first. A scenario saved before versions were recorded closes its history with a synthesized Created entry.



## OpenAPI

````yaml GET /api/scenarios/{id}/versions
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:
    get:
      description: >-
        List the saved versions of a scenario, newest first. A scenario saved
        before versions were recorded closes its history with a synthesized
        Created entry.
      operationId: getApiScenariosByIdVersions
      parameters:
        - in: query
          name: limit
          schema:
            type: integer
            minimum: 1
            maximum: 100
        - in: query
          name: cursor
          schema:
            type: integer
            minimum: 1
          description: Read the page below this version number.
        - schema:
            type: string
          in: path
          name: id
          required: true
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  versions:
                    type: array
                    items:
                      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.
                      required:
                        - version
                        - authorLabel
                        - authorId
                        - changeDescription
                        - changedFields
                        - createdAt
                        - isSynthesized
                  nextCursor:
                    type:
                      - integer
                      - 'null'
                    description: >-
                      Pass as cursor to read the page below this one. Null on
                      the last page.
                required:
                  - versions
                  - nextCursor
        '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 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.

````