Update Agent Flow Draft | SpeechifyAI API

curl -X PUT https://api.speechify.ai/v1/agents/agent_01k7m6etzwf057j6w0zmdsgppr/flow \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "nodes": [
    {}
  ],
  "edges": [
    {}
  ],
  "name": "Example name",
  "notes": "example",
  "variables": [
    {}
  ]
}'

{
  "version": {
    "id": "fver_01arz3ndektsv4rrffq69g5fav",
    "agent_id": "agent_01k7m6etzwf057j6w0zmdsgppr",
    "version": 1,
    "is_active": true,
    "is_draft": true,
    "parent_version_id": "fver_01arz3ndektsv4rrffq69g5fav",
    "name": "Example name",
    "notes": "example",
    "published_at": "2026-06-24T18:03:11Z",
    "updated_at": "2026-06-24T18:03:11Z"
  },
  "nodes": [
    {}
  ],
  "edges": [
    {}
  ],
  "variables": [
    {}
  ]
}

Replace the agent’s draft flow graph. The graph is validated before it is stored; publish it separately to make it active.

Authentication

AuthorizationBearer

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

Path parameters

agent_idstringRequired

Prefixed agent id.

Request

This endpoint expects an object.

nodeslist of objectsRequired

edgeslist of objectsRequired

namestringOptional

notesstringOptional

variableslist of objectsOptional

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 stored draft graph.

versionobject

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

nodeslist of objects

edgeslist of objects

variableslist of objects

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

409

Conflict Error

500

Internal Server Error