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

# Get workflow version

> <Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Reads one saved version's full definition.

Use it to see the definition a past run actually executed, which is not always the current one. Each run reports the version it ran as `definition_version_id` on [Get workflow run](/api-reference/get-workflow-run).

This endpoint is limited to 30 requests per minute.



## OpenAPI

````yaml /developers/references/app-management/app-management-openapi.json get /api/apps/{app_id}/workflows/{workflow_id}/versions/{version_id}
openapi: 3.1.0
info:
  title: Base44 App Management API
  version: 1.0.0
servers:
  - url: https://app.base44.com
security:
  - ApiKeyAuth: []
paths:
  /api/apps/{app_id}/workflows/{workflow_id}/versions/{version_id}:
    get:
      summary: Get workflow version
      description: >-
        <Info>This API is in beta. Endpoints, fields, and behavior may still
        change, so avoid depending on it in production.</Info>


        Reads one saved version's full definition.


        Use it to see the definition a past run actually executed, which is not
        always the current one. Each run reports the version it ran as
        `definition_version_id` on [Get workflow
        run](/api-reference/get-workflow-run).


        This endpoint is limited to 30 requests per minute.
      operationId: >-
        get_version_api_apps__app_id__workflows__workflow_id__versions__version_id__get
      parameters:
        - name: app_id
          in: path
          required: true
          schema:
            type: string
            description: ID of the app whose workflows you want to work with.
            title: App Id
          description: ID of the app whose workflows you want to work with.
          example: 6820f3a4e7b91d003c45a1f2
        - name: workflow_id
          in: path
          required: true
          schema:
            type: string
            description: >-
              ID of the workflow, as returned in `id` by [List
              workflows](/api-reference/list-workflows).
            title: Workflow Id
          description: >-
            ID of the workflow, as returned in `id` by [List
            workflows](/api-reference/list-workflows).
          example: 68b1c0d4e7b91d003c45a1f2
        - name: version_id
          in: path
          required: true
          schema:
            type: string
            description: >-
              ID of the version, as returned in `version_id` by [List workflow
              versions](/api-reference/list-workflow-versions). It is the
              SHA-256 hash of the definition, not a Base44 object ID.
            title: Version Id
          description: >-
            ID of the version, as returned in `version_id` by [List workflow
            versions](/api-reference/list-workflow-versions). It is the SHA-256
            hash of the definition, not a Base44 object ID.
          example: 9f2c1a7b3e5d84f60c1b2a9e7d4f8c3b6a5e2d1f0c9b8a7e6d5c4b3a2f1e0d9c
      responses:
        '200':
          description: The version and its definition.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VersionDefinitionResponse'
        '401':
          description: Missing or invalid credentials.
        '403':
          description: >-
            You don't have access to this app, the app does not exist, the app
            still runs the older automations engine instead of workflows, or you
            used a workspace API key.
        '404':
          description: >-
            There is no workflow with this ID on this app, or no version with
            this ID on that workflow.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    VersionDefinitionResponse:
      properties:
        version_id:
          type: string
          title: Version Id
          description: ID of the version, which is the SHA-256 hash of its definition.
          example: 9f2c1a7b3e5d84f60c1b2a9e7d4f8c3b6a5e2d1f0c9b8a7e6d5c4b3a2f1e0d9c
        definition:
          additionalProperties: true
          type: object
          title: Definition
          description: >-
            The steps this version runs, as a CNCF Serverless Workflow v1.0
            document.
          example:
            do: []
            document:
              dsl: 1.0.0
              name: notify
              version: 1.0.0
      type: object
      required:
        - version_id
        - definition
      title: VersionDefinitionResponse
      description: A single immutable version with its full definition.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: api_key
      description: Personal API key.

````