> ## Documentation Index > Fetch the complete documentation index at: https://docs.summation.com/llms.txt > Use this file to discover all available pages before exploring further. # List workflow versions > List a workflow's frozen versions, newest first. Each one is what an activation shipped, with the workflow revision it was frozen from — which is how you tell whether the workflow has been edited since it was last activated. ## OpenAPI ````yaml https://api.summation.com/openapi.json get /v1/workflows/{workflow_id}/versions openapi: 3.1.0 info: title: summation-api public API version: 0.1.0 servers: [] security: [] tags: - name: Auth description: Machine authentication for API clients. - name: Tenant description: Organization and tenant context resolved by summation-api. - name: Projects description: Project resources. - name: Conversations description: Conversation and message resources. - name: Reports description: Report resources and report operations. - name: Runs description: Project run history and execution status. - name: Playbooks description: Playbook resources. - name: Files description: Project file resources. - name: Catalog Entries description: Project-scoped data asset attachments. - name: Data Connectors description: Reusable external data source connections. - name: App Connectors description: External app connectors whose tools the agent can use during chat. - name: Tables description: Canonical table metadata and catalog. - name: Views description: Canonical Summation view metadata and catalog. - name: Query Executions description: Read-only SQL query execution. - name: Grid description: Materialized grid status, sync, and lineage. - name: Schedules description: Schedule and schedule run inspection. - name: Workflows description: >- Workflows: what they run, when they run, and where their output is delivered. - name: Verification Tests description: >- Administrative custom verification-test definitions, overlays, and effective-set previews. paths: /v1/workflows/{workflow_id}/versions: get: tags: - Workflows summary: List workflow versions description: >- List a workflow's frozen versions, newest first. Each one is what an activation shipped, with the workflow revision it was frozen from — which is how you tell whether the workflow has been edited since it was last activated. operationId: list_workflow_versions parameters: - name: workflow_id in: path required: true schema: type: string title: Workflow Id - name: page_token in: query required: false schema: anyOf: - type: string - type: 'null' description: Token from a previous page's next_page_token. title: Page Token description: Token from a previous page's next_page_token. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/WorkflowVersionListResponse' '400': description: Invalid request or unsupported option. content: application/problem+json: schema: $ref: '#/components/schemas/ProblemError' '401': description: Missing, invalid, or expired credentials. content: application/problem+json: schema: $ref: '#/components/schemas/ProblemError' '403': description: Authenticated but missing the required scope. content: application/problem+json: schema: $ref: '#/components/schemas/ProblemError' '404': description: Resource not found or not accessible. content: application/problem+json: schema: $ref: '#/components/schemas/ProblemError' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '429': description: Rate limit exceeded. content: application/problem+json: schema: $ref: '#/components/schemas/ProblemError' '500': description: Internal server error. content: application/problem+json: schema: $ref: '#/components/schemas/ProblemError' '503': description: >- The workflows service is temporarily unavailable. Retry this request shortly. content: application/problem+json: schema: $ref: '#/components/schemas/ProblemError' security: - SummationMachineAuth: - agent:read components: schemas: WorkflowVersionListResponse: properties: data: $ref: '#/components/schemas/WorkflowVersionListData' type: object required: - data title: WorkflowVersionListResponse ProblemError: description: >- Public error envelope (RFC 7807 ``application/problem+json``). Mirrors the body produced by :func:`api_error`. Declaring it in the contract lets generated clients type error handling instead of guessing. properties: type: description: URI reference identifying the problem type. title: Type type: string title: description: Short, human-readable summary of the problem type. title: Title type: string status: description: HTTP status code. title: Status type: integer detail: description: Human-readable explanation specific to this occurrence. title: Detail type: string code: description: Stable, machine-readable error code. title: Code type: string request_id: description: Correlation id, echoed in the x-request-id header. title: Request Id type: string required: - type - title - status - detail - code - request_id title: ProblemError type: object HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError WorkflowVersionListData: properties: versions: items: $ref: '#/components/schemas/WorkflowVersion' type: array title: Versions description: Newest first. nextPageToken: anyOf: - type: string - type: 'null' title: Nextpagetoken type: object required: - versions title: WorkflowVersionListData 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 WorkflowVersion: properties: id: type: string title: Id workflowId: type: string title: Workflowid versionNumber: type: integer title: Versionnumber executionFormat: type: string title: Executionformat sourceRevision: type: integer title: Sourcerevision description: The workflow revision this version was frozen from. createdBy: type: string title: Createdby createdAt: anyOf: - type: string - type: 'null' title: Createdat type: object required: - id - workflowId - versionNumber - executionFormat - sourceRevision - createdBy title: WorkflowVersion description: >- An immutable snapshot of what a workflow runs, minted by activation. Metadata ONLY, deliberately: the frozen document itself is not projected. What activation writes into ``workflow_versions.definition_json`` is an executor artifact, not a caller document — TypedWorkflowDefinitionFreezer writes the compiled execution plan alongside the graph, and every skill node's resolved manifest with it (``packagePath``, ``packageDigest``, and per-file ``fileId``/``fileVersionId``/``contentHash``). Those are internal wire format and project-internal paths, which no public payload may carry (see AGENTS.md). The document a caller AUTHORED is the workflow's own ``graph``, which GET /v1/workflows/{id} returns; a version answers a different question — WHICH revision is live and when it shipped — and ``source_revision`` against the workflow's ``revision`` is the whole of that answer. The executor template a version is pinned to is internal for the same reason and is likewise never projected. securitySchemes: SummationMachineAuth: type: oauth2 flows: clientCredentials: scopes: agent:read: agent:read agent:write: agent:write tokenUrl: /v1/auth/m2m/token ````