Get Agent Flow Version | Speechify API

curl https://api.speechify.ai/v1/agents/agent_01k7m6etzwf057j6w0zmdsgppr/flow/versions/fver_01arz3ndektsv4rrffq69g5fav \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json"

{
  "version": {
    "id": "fver_01arz3ndektsv4rrffq69g5fav",
    "agent_id": "agent_01k7m6etzwf057j6w0zmdsgppr",
    "version": 3,
    "is_active": true,
    "is_draft": false,
    "parent_version_id": "fver_01arz3ndektsv4rrffq69g5fau",
    "name": "Customer Support Flow v3",
    "notes": "Updated flow to include new greeting and fallback logic",
    "published_at": "2026-06-24T18:03:11Z",
    "updated_at": "2026-06-24T18:03:11Z"
  },
  "nodes": [
    {
      "id": "node_001",
      "label": "Start Node",
      "metadata": {
        "created_at": "2026-06-20T09:00:00Z",
        "created_by": "Cliff Weitzman"
      },
      "type": "start"
    },
    {
      "content": "Hello! Welcome to Acme Inc customer support. How can I assist you today?",
      "id": "node_002",
      "label": "Greeting",
      "type": "text_to_speech",
      "voice": "en-US-Wavenet-D"
    },
    {
      "expected_input": "text",
      "id": "node_003",
      "label": "User Input",
      "type": "input"
    }
  ],
  "edges": [
    {
      "condition": null,
      "id": "edge_001",
      "source": "node_001",
      "target": "node_002"
    },
    {
      "condition": null,
      "id": "edge_002",
      "source": "node_002",
      "target": "node_003"
    }
  ],
  "variables": [
    {
      "default": "Cliff",
      "description": "Name of the user interacting with the agent",
      "name": "user_name",
      "type": "string"
    },
    {
      "default": "sess_01k7m6etzwf057j6w0zmdsgppr",
      "description": "Unique session identifier for the conversation",
      "name": "session_id",
      "type": "string"
    }
  ]
}

Return the full flow graph for a specific published version.

Authentication

AuthorizationBearer

Enter your API key with the Bearer prefix, e.g. ‘Bearer sk_…’.

Path parameters

agent_idstringRequired

Prefixed agent id.

version_idstringRequired

Prefixed flow version id (fver_...).

Response headers

X-Request-IDstring

Unique identifier for this request, present on every response (2xx and non-2xx alike). If the caller sends an X-Request-ID request header the server echoes it back (sanitized and length-capped) so one logical request can be traced end-to-end; otherwise the server generates a fresh value. Log it on every response and quote it in support requests - it is the stable handle that ties your observation to Speechify’s server-side logs, and it matches the request_id field in the error envelope.

Unique identifier for this request, present on every response (2xx and non-2xx alike). If the caller sends an `X-Request-ID` request header the server echoes it back (sanitized and length-capped) so one logical request can be traced end-to-end; otherwise the server generates a fresh value. Log it on every response and quote it in support requests - it is the stable handle that ties your observation to Speechify's server-side logs, and it matches the `request_id` field in the error envelope.

Response

The requested flow version's graph.

versionobject

One published or draft revision of an agent's flow graph.

nodeslist of objects

edgeslist of objects

variableslist of objects

Errors

401

Unauthorized Error

404

Not Found Error

500

Internal Server Error

Authentication

Path parameters

Headers

Response headers

Response

Errors