v5

OpenAPI 3.1.02026-08-043621,4011.8 MB

Agents Platform

Create Procedure

Create a new procedure for the agent on a branch.

post/v1/convai/agents/{agent_id}/branches/{branch_id}/procedures

Path parameters

agent_idstring required

Agent ID to get the procedure draft from

Example:agent_3701k3ttaq12ewp8b7qv5rfyszkz

Agent ID to get the procedure draft from

branch_idstring required

Branch ID to get the procedure draft from

Example:agtbranch_0901k4aafjxxfxt93gd841r7tv5t

Branch ID to get the procedure draft from

Headers

xi-api-keystring nullable

Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

Request body

namestring

Procedure name

contentstring

Initial procedure content

type'free_form' | 'deterministic'

triggerstring nullable

When the agent should use this procedure. Empty string means this is a sub-procedure that should only start when another procedure references it. If omitted or null, the trigger is derived from the content instead. Also accepts description as an alias.

Response

Successful Response

procedure_idstring required

ID of the created procedure

Example response

{
  "procedure_id": "agtprc_6qbpwdq8n01bxhk44bgjy6f10ck3"
}