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

# List workflow versions

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

Lists a workflow's saved versions, newest first.

Every definition change saves a version, so this is the history of what the workflow has run. Read one with [Get workflow version](/api-reference/get-workflow-version).

`limit` caps at 200 and there is no paging, so a workflow edited more than 200 times returns only its most recent 200 versions with nothing in the response saying so.

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
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:
    get:
      summary: List workflow versions
      description: >-
        <Info>This API is in beta. Endpoints, fields, and behavior may still
        change, so avoid depending on it in production.</Info>


        Lists a workflow's saved versions, newest first.


        Every definition change saves a version, so this is the history of what
        the workflow has run. Read one with [Get workflow
        version](/api-reference/get-workflow-version).


        `limit` caps at 200 and there is no paging, so a workflow edited more
        than 200 times returns only its most recent 200 versions with nothing in
        the response saying so.


        This endpoint is limited to 30 requests per minute.
      operationId: list_versions_api_apps__app_id__workflows__workflow_id__versions_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: limit
          in: query
          required: false
          schema:
            type: integer
            maximum: 200
            minimum: 1
            description: Most versions to return.
            default: 30
            title: Limit
          description: Most versions to return.
          example: 30
      responses:
        '200':
          description: The workflow's versions, newest first.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/VersionItem'
                title: WorkflowVersions
        '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. A missing app and an app you cannot reach
            are deliberately the same answer.
        '404':
          description: There is no workflow with this ID on this app.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    VersionItem:
      properties:
        version_id:
          type: string
          title: Version Id
          description: ID of the version, which is the SHA-256 hash of its definition.
          example: 9f2c1a7b3e5d84f60c1b2a9e7d4f8c3b6a5e2d1f0c9b8a7e6d5c4b3a2f1e0d9c
        workflow_id:
          type: string
          title: Workflow Id
          description: ID of the workflow it belongs to.
          example: 68b1c0d4e7b91d003c45a1f2
        created_by:
          anyOf:
            - type: string
            - type: 'null'
          title: Created By
          description: Email of whoever saved this version.
          example: you@example.com
        change_summary:
          anyOf:
            - type: string
            - type: 'null'
          title: Change Summary
          description: The note saved with this version, when one was given.
          example: Send to the ops alias instead
        created_date:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Created Date
          description: When the version was saved.
          example: '2026-08-20T16:31:00Z'
      type: object
      required:
        - version_id
        - workflow_id
      title: VersionItem
    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.

````