Clone Flow Template | SpeechifyAI API

Clone a flow template onto an agent as a new draft graph.

Authentication

AuthorizationBearer

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

Path parameters

flow_template_idstringRequired

Flow template id (prefixed external id, tmpl_...).

Request

This endpoint expects an object.

agent_idstringRequired

The agent that receives the cloned graph as a new draft.

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 agent's new 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

$	curl -X POST https://api.speechify.ai/v1/agents/flow/templates/tmpl_01arz3ndektsv4rrffq69g5fav/clone \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"agent_id": "agent_01k7m6etzwf057j6w0zmdsgppr"
>	}'

1	{
2	"version": {
3	"id": "fver_01arz3ndektsv4rrffq69g5fav",
4	"agent_id": "agent_01k7m6etzwf057j6w0zmdsgppr",
5	"version": 1,
6	"is_active": true,
7	"is_draft": true,
8	"parent_version_id": "fver_01arz3ndektsv4rrffq69g5fav",
9	"name": "Example name",
10	"notes": "example",
11	"published_at": "2026-06-24T18:03:11Z",
12	"updated_at": "2026-06-24T18:03:11Z"
13	},
14	"nodes": [
15	{}
16	],
17	"edges": [
18	{}
19	],
20	"variables": [
21	{}
22	]
23	}