Get Agent Flow Version

Beta
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_...).

Headers

Speechify-VersionstringOptional

Response headers

Speechify-Request-IdstringOptional
Unique identifier for this request, present on every response (2xx and non-2xx alike). If the caller sends a `Speechify-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. The legacy alias `X-Request-ID` carries the same value and is still accepted on requests, until 2027-07-24. Prefer the un-prefixed name (RFC 6648).

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 objectsOptional

Errors

401
Unauthorized Error
404
Not Found Error
500
Internal Server Error