List Procedures

GET

/v1/convai/agents/:agent_id/branches/:branch_id/procedures

GET

/v1/convai/agents/:agent_id/branches/:branch_id/procedures

$ curl -G https://api.elevenlabs.io/v1/convai/agents/agent_3701k3ttaq12ewp8b7qv5rfyszkz/branches/agtbranch_0901k4aafjxxfxt93gd841r7tv5t/procedures \
>      -d agent_version_id=agent_version_id

1 {
2   "procedures": [
3     {
4       "procedure_id": "agtprc_6qbpwdq8n01bxhk44bgjy6f10ck3",
5       "has_draft": false,
6       "version_id": "agtprcv_7rbqxer9o12cyxi55ckw6sgz1dl4",
7       "name": "Customer Support Procedure",
8       "type": "free_form",
9       "trigger": "When the customer asks for support",
10       "referenced_tool_ids": [
11         "tool_123"
12       ],
13       "referenced_kb_ids": [
14         "kb_123"
15       ],
16       "referenced_procedure_ids": [
17         "agtprc_other"
18       ],
19       "referenced_dynamic_variables": [
20         "customer_id"
21       ],
22       "folder_parent_id": "folder_parent_id"
23     }
24   ]
25 }

List the procedures attached to this agent branch. By default, unpublished drafts take precedence over the latest committed version. Pass agent_version_id to list a published snapshot instead. has_draft is true when a procedure has unpublished draft changes on this branch. Procedure content is not included; use Get Procedure to read a procedure’s body.

Path parameters

agent_idstringRequired

Agent ID to get the procedure draft from

branch_idstringRequired

Branch ID to get the procedure draft from

Query parameters

agent_version_idstringOptional

The agent version ID to retrieve the procedure for.

Response

Successful Response

procedureslist of objects

Procedures on the branch with their draft-aware metadata.

Errors

422

Procedures List Request Unprocessable Entity Error

Path parameters

Headers

Query parameters

Response

Errors