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

# Get Workflow Version

> Get a specific workflow version



## OpenAPI

````yaml /openapi.json get /workflow/workflows/{workflow_id}/versions/{version_number}
openapi: 3.1.0
info:
  title: Anyreach API
  version: 1.0.0
  description: >-
    REST API for the Anyreach platform.


    Every endpoint is scoped to one organization. Authenticate with a bearer
    token and, if your token can reach more than one organization, name the one
    you mean with the `X-Anyreach-Org` header. See
    [Authentication](https://docs.anyreach.ai/api-reference/authentication).


    This reference is generated from the running service, so the request and
    response shapes here are the ones the API actually enforces.
servers:
  - url: https://api.anyreach.ai
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Agents
    description: >-
      Create and configure the agent that handles a conversation, and manage its
      versions. An agent's behaviour lives in a version; publishing a version is
      what puts it on the air.
  - name: Conversations
    description: >-
      Create, list, retrieve, and message conversations between your users and
      Anyreach agents.
  - name: Conversation attachments
    description: >-
      Upload files into a conversation and read them back. Uploads are two-step:
      presign, PUT to the returned URL, then mark the attachment complete.
  - name: Conversation events
    description: >-
      The ordered event stream behind a conversation — turns, tool calls,
      transfers, and status changes.
  - name: Knowledge bases
    description: >-
      A knowledge base (a `dataset` in the API) is a collection of embedded
      content an agent can retrieve from.
  - name: Knowledge base sources
    description: Attach and detach sources to a knowledge base.
  - name: Sources
    description: >-
      A source is a file or URL whose content is ingested, chunked, and
      embedded.
  - name: Phone numbers
    description: >-
      Buy, list, and release phone numbers, and point each one at the agent that
      should answer it.
  - name: Trunks
    description: >-
      SIP trunks for bringing your own carrier. A trunk carries calls between
      your carrier and Anyreach.
  - name: Inbound routing
    description: >-
      Rules that decide which agent answers an inbound call, evaluated before
      the call connects.
  - name: Agent assist
    description: >-
      Look up the live-assist context for a number so a human agent can see what
      the AI agent knows.
  - name: Human handoff
    description: >-
      Connections to the help desk a conversation escalates into, and the test
      endpoint that proves one works.
  - name: Email domains
    description: >-
      Register a sending domain and verify its DNS before an agent can send from
      it.
  - name: Email addresses
    description: >-
      The addresses on a verified domain, and the agent that handles mail
      arriving at each one.
  - name: Unsubscribes
    description: >-
      The suppression list. An address on this list is never emailed again until
      it is removed.
  - name: Web widgets
    description: >-
      The embeddable chat and voice widget: its appearance, its allowed domains,
      and the agent behind it.
  - name: Campaigns
    description: >-
      An outbound campaign dials a contact list with a given agent on a given
      schedule. Start, pause, and close control its lifecycle.
  - name: Campaign contacts
    description: >-
      The people a campaign dials. Contacts can be added while the campaign is
      running.
  - name: Campaign configurations
    description: >-
      Reusable dialing settings — calling windows, retry policy, timezone
      handling — that campaigns reference.
  - name: Campaign stats
    description: >-
      Per-campaign outcome counters, and the organization-wide cap on how many
      calls run at once.
  - name: Custom data
    description: >-
      Your own tables, queryable by an agent mid-conversation. Define a table,
      load rows, and expose read-only stored queries as agent tools.
  - name: Metrics
    description: >-
      The definitions an LLM judge scores a conversation against. Lint and
      preview a metric before you run it at scale.
  - name: Evaluations
    description: A scorecard binding a set of metrics to a population of conversations.
  - name: Evaluation runs
    description: >-
      One execution of an evaluation over a conversation set, and the results it
      produced.
  - name: Workflows
    description: >-
      Automations built from steps. A workflow is edited as a version and goes
      live when a version is published and set live.
  - name: Workflow triggers
    description: >-
      What starts a workflow — a schedule, a webhook, or a point in an agent
      conversation. Triggers are versioned alongside the workflow.
  - name: Workflow executions
    description: >-
      Run a workflow and read back what happened. Executions are synchronous by
      default; use the async endpoint for long-running work.
  - name: Workflow credentials
    description: >-
      Secrets a workflow step authenticates with. Values are write-only — they
      can be set and rotated, never read back.
paths:
  /workflow/workflows/{workflow_id}/versions/{version_number}:
    get:
      tags:
        - Workflows
      summary: Get Workflow Version
      description: Get a specific workflow version
      operationId: getWorkflowVersion
      parameters:
        - name: workflow_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Workflow Id
        - name: version_number
          in: path
          required: true
          schema:
            type: integer
            title: Version Number
        - name: x-anyreach-org
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Organization ID for user PATs (pat_ prefix tokens)
            title: X-Anyreach-Org
          description: Organization ID for user PATs (pat_ prefix tokens)
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkflowVersionSchema'
              example:
                id: 3fa85f64-5717-4562-b3fc-2c963f66afa6
                workflow_id: 3fa85f64-5717-4562-b3fc-2c963f66afa6
                version: 1
                organization_id: 3fa85f64-5717-4562-b3fc-2c963f66afa6
                is_published: false
                is_live: false
                created_at: '2026-01-15T09:30:00Z'
                updated_at: '2026-01-15T09:30:00Z'
                created_by: user:3fa85f64-5717-4562-b3fc-2c963f66afa6
                modified_by: user:3fa85f64-5717-4562-b3fc-2c963f66afa6
                definition:
                  key:
                    id: null
                    name: null
                    next_step_id: null
                    ai_config: null
                    ui_config: null
                    type: null
                    source: null
                    operation: null
                    operation_input: null
                starting_step: string
        '404':
          description: Not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    WorkflowVersionSchema:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        workflow_id:
          type: string
          format: uuid
          title: Workflow Id
        version:
          type: integer
          title: Version
        organization_id:
          type: string
          title: Organization Id
        is_published:
          type: boolean
          title: Is Published
        is_live:
          type: boolean
          title: Is Live
        created_at:
          type: string
          format: date-time
          title: Created At
        updated_at:
          type: string
          format: date-time
          title: Updated At
        created_by:
          anyOf:
            - type: string
            - type: 'null'
          title: Created By
        modified_by:
          anyOf:
            - type: string
            - type: 'null'
          title: Modified By
        definition:
          $ref: '#/components/schemas/Workflow-Output'
        starting_step:
          anyOf:
            - type: string
            - type: 'null'
          title: Starting Step
      type: object
      required:
        - id
        - workflow_id
        - version
        - organization_id
        - is_published
        - is_live
        - created_at
        - updated_at
        - definition
        - starting_step
      title: WorkflowVersionSchema
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    Workflow-Output:
      additionalProperties:
        oneOf:
          - $ref: '#/components/schemas/AppStep'
          - $ref: '#/components/schemas/ConditionStep'
          - $ref: '#/components/schemas/OutputStep-Output'
          - $ref: '#/components/schemas/TransformStep-Output'
          - $ref: '#/components/schemas/CodeStep-Output'
          - $ref: '#/components/schemas/HttpStep'
          - $ref: '#/components/schemas/NoteStep'
          - $ref: '#/components/schemas/TriggerStep'
          - $ref: '#/components/schemas/WaitStep'
          - $ref: '#/components/schemas/GenericInputStep-Output'
        discriminator:
          propertyName: type
          mapping:
            app:
              $ref: '#/components/schemas/AppStep'
            code:
              $ref: '#/components/schemas/CodeStep-Output'
            condition:
              $ref: '#/components/schemas/ConditionStep'
            http:
              $ref: '#/components/schemas/HttpStep'
            input:
              $ref: '#/components/schemas/GenericInputStep-Output'
            note:
              $ref: '#/components/schemas/NoteStep'
            output:
              $ref: '#/components/schemas/OutputStep-Output'
            transform:
              $ref: '#/components/schemas/TransformStep-Output'
            trigger:
              $ref: '#/components/schemas/TriggerStep'
            wait:
              $ref: '#/components/schemas/WaitStep'
      type: object
      title: Workflow
    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
    AppStep:
      properties:
        id:
          type: string
          title: Id
        name:
          type: string
          title: Name
          default: ''
        next_step_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Next Step Id
        ai_config:
          $ref: '#/components/schemas/AiConfig'
        ui_config:
          $ref: '#/components/schemas/UiConfig'
        type:
          type: string
          const: app
          title: Type
          default: app
        source:
          type: string
          title: Source
          description: e.g. 'http', 'pipedream'
        operation:
          type: string
          title: Operation
        operation_input:
          additionalProperties: true
          type: object
          title: Operation Input
          default: {}
      type: object
      required:
        - id
        - source
        - operation
      title: AppStep
    ConditionStep:
      properties:
        id:
          type: string
          title: Id
        name:
          type: string
          title: Name
          default: ''
        next_step_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Next Step Id
        ai_config:
          $ref: '#/components/schemas/AiConfig'
        ui_config:
          $ref: '#/components/schemas/UiConfig'
        type:
          type: string
          const: condition
          title: Type
          default: condition
        conditions:
          items:
            $ref: '#/components/schemas/Condition'
          type: array
          title: Conditions
      additionalProperties: false
      type: object
      required:
        - id
        - conditions
      title: ConditionStep
    OutputStep-Output:
      properties:
        id:
          type: string
          title: Id
        name:
          type: string
          title: Name
          default: ''
        next_step_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Next Step Id
        ai_config:
          $ref: '#/components/schemas/AiConfig'
        ui_config:
          $ref: '#/components/schemas/UiConfig'
        type:
          type: string
          const: output
          title: Type
          default: output
        output_schema:
          additionalProperties:
            $ref: '#/components/schemas/DataSchema-Output'
          type: object
          title: Output Schema
          description: The output schema of the step
        output_data:
          additionalProperties: true
          type: object
          title: Output Data
          description: The output data of the step
      additionalProperties: false
      type: object
      required:
        - id
        - output_schema
        - output_data
      title: OutputStep
    TransformStep-Output:
      properties:
        id:
          type: string
          title: Id
        name:
          type: string
          title: Name
          default: ''
        next_step_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Next Step Id
        ai_config:
          $ref: '#/components/schemas/AiConfig'
        ui_config:
          $ref: '#/components/schemas/UiConfig'
        type:
          type: string
          const: transform
          title: Type
          default: transform
        output_schema:
          additionalProperties:
            $ref: '#/components/schemas/DataSchema-Output'
          type: object
          title: Output Schema
          description: The schema of the transformed fields
        output_data:
          additionalProperties: true
          type: object
          title: Output Data
          description: The field expressions of the transform step
      additionalProperties: false
      type: object
      required:
        - id
        - output_schema
        - output_data
      title: TransformStep
      description: >-
        A pass-through step that builds a named, typed JSON object from JSONata

        expressions and records it under this step's id so later steps can
        reference

        it (e.g. ``{{ <stepId>.field }}``).


        Unlike ``OutputStep`` it is not terminal: it continues to
        ``next_step_id``

        and does not set the workflow output. The ``output_schema`` /
        ``output_data``

        field names mirror ``OutputStep`` so the two share a single frontend
        editor.
    CodeStep-Output:
      properties:
        id:
          type: string
          title: Id
        name:
          type: string
          title: Name
          default: ''
        next_step_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Next Step Id
        ai_config:
          $ref: '#/components/schemas/AiConfig'
        ui_config:
          $ref: '#/components/schemas/UiConfig'
        type:
          type: string
          const: code
          title: Type
          default: code
        language:
          type: string
          const: python
          title: Language
          default: python
        code:
          type: string
          title: Code
        packages:
          items:
            type: string
          type: array
          title: Packages
          default:
            - requests
        return_value_schema:
          anyOf:
            - $ref: '#/components/schemas/DataSchema-Output'
            - type: 'null'
      additionalProperties: false
      type: object
      required:
        - id
        - code
      title: CodeStep
    HttpStep:
      properties:
        id:
          type: string
          title: Id
        name:
          type: string
          title: Name
          default: ''
        next_step_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Next Step Id
        ai_config:
          $ref: '#/components/schemas/AiConfig'
        ui_config:
          $ref: '#/components/schemas/UiConfig'
        type:
          type: string
          const: http
          title: Type
          default: http
        method:
          $ref: '#/components/schemas/HttpMethod'
          default: GET
        url:
          type: string
          title: Url
          default: ''
        headers:
          additionalProperties: true
          type: object
          title: Headers
        query_params:
          additionalProperties: true
          type: object
          title: Query Params
        body_type:
          $ref: '#/components/schemas/BodyType'
          default: json
        body:
          anyOf:
            - additionalProperties: true
              type: object
            - type: string
          title: Body
      additionalProperties: false
      type: object
      required:
        - id
      title: HttpStep
    NoteStep:
      properties:
        id:
          type: string
          title: Id
        name:
          type: string
          title: Name
          default: ''
        next_step_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Next Step Id
        ai_config:
          $ref: '#/components/schemas/AiConfig'
        ui_config:
          $ref: '#/components/schemas/UiConfig'
        type:
          type: string
          const: note
          title: Type
          default: note
        content:
          type: string
          title: Content
          default: ''
      additionalProperties: false
      type: object
      required:
        - id
      title: NoteStep
    TriggerStep:
      properties:
        id:
          type: string
          title: Id
        name:
          type: string
          title: Name
          default: ''
        next_step_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Next Step Id
        ai_config:
          $ref: '#/components/schemas/AiConfig'
        ui_config:
          $ref: '#/components/schemas/UiConfig'
        type:
          type: string
          const: trigger
          title: Type
          default: trigger
        source:
          type: string
          title: Source
          default: pipedream
        app_name:
          type: string
          title: App Name
          default: ''
        trigger_key:
          type: string
          title: Trigger Key
          default: ''
        configured_props:
          additionalProperties: true
          type: object
          title: Configured Props
        external_user_id:
          type: string
          title: External User Id
          default: ''
        event_schema:
          additionalProperties: true
          type: object
          title: Event Schema
      additionalProperties: false
      type: object
      required:
        - id
      title: TriggerStep
    WaitStep:
      properties:
        id:
          type: string
          title: Id
        name:
          type: string
          title: Name
          default: ''
        next_step_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Next Step Id
        ai_config:
          $ref: '#/components/schemas/AiConfig'
        ui_config:
          $ref: '#/components/schemas/UiConfig'
        type:
          type: string
          const: wait
          title: Type
          default: wait
        duration_seconds:
          type: integer
          minimum: 1
          title: Duration Seconds
      additionalProperties: false
      type: object
      required:
        - id
        - duration_seconds
      title: WaitStep
      description: Action node that pauses workflow execution via a Temporal durable timer.
    GenericInputStep-Output:
      properties:
        id:
          type: string
          title: Id
        name:
          type: string
          title: Name
          default: ''
        next_step_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Next Step Id
        ai_config:
          $ref: '#/components/schemas/AiConfig'
        ui_config:
          $ref: '#/components/schemas/UiConfig'
        type:
          type: string
          const: input
          title: Type
          default: input
        input_type:
          type: string
          const: generic_input
          title: Input Type
          default: generic_input
        data_schema:
          additionalProperties:
            $ref: '#/components/schemas/DataSchema-Output'
          type: object
          title: Data Schema
        input_schema:
          additionalProperties: true
          type: object
          title: Input Schema
      additionalProperties: false
      type: object
      required:
        - id
      title: GenericInputStep
    AiConfig:
      properties:
        provider:
          type: string
          title: Provider
          default: openai
        model:
          type: string
          title: Model
          default: gpt-5.1
      type: object
      title: AiConfig
    UiConfig:
      properties:
        position:
          $ref: '#/components/schemas/UiConfigPosition'
        dimensions:
          $ref: '#/components/schemas/UiConfigDimensions'
      type: object
      title: UiConfig
    Condition:
      properties:
        condition:
          type: string
          title: Condition
        label:
          type: string
          title: Label
          default: ''
        ai_instruction:
          anyOf:
            - type: string
            - type: 'null'
          title: Ai Instruction
        next_step_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Next Step Id
        ui_config:
          $ref: '#/components/schemas/UiConfig'
      type: object
      required:
        - condition
      title: Condition
    DataSchema-Output:
      properties:
        data_type:
          $ref: '#/components/schemas/DataType'
          description: >-
            The type of the data, could be one of the following: 'string',
            'number', 'boolean', 'array', 'object'
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
          description: The description of the data
          default: ''
        choices:
          anyOf:
            - items: {}
              type: array
            - type: 'null'
          title: Choices
          description: The choices of the data as per the data type
          default: []
        is_required:
          type: boolean
          title: Is Required
          description: Whether the data is required
          default: false
        children:
          anyOf:
            - additionalProperties:
                $ref: '#/components/schemas/DataSchema-Output'
              type: object
            - type: 'null'
          title: Children
          description: Nested schema for object-type data
      type: object
      required:
        - data_type
      title: DataSchema
    HttpMethod:
      type: string
      enum:
        - GET
        - POST
        - PUT
        - PATCH
        - DELETE
        - HEAD
        - OPTIONS
      title: HttpMethod
    BodyType:
      type: string
      enum:
        - json
        - form
        - raw
      title: BodyType
    UiConfigPosition:
      properties:
        x:
          type: number
          title: X
          default: 0
        'y':
          type: number
          title: 'Y'
          default: 0
      type: object
      title: UiConfigPosition
    UiConfigDimensions:
      properties:
        width:
          type: number
          title: Width
          default: 250
        height:
          type: number
          title: Height
          default: 44
      type: object
      title: UiConfigDimensions
    DataType:
      type: string
      enum:
        - string
        - number
        - boolean
        - array
        - object
      title: DataType
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Personal access token or organization API key. See Authentication.

````