curl -X PUT "https://app.talkover.ai/api/v1/agents/agent-uuid-1/callback" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-H "Content-Type: application/json" \
-d '{
"source_agent_ids": ["agent-uuid-2"]
}'
{
"success": true,
"data": {
"id": "agent-uuid-1",
"callback_config": {
"source_agent_ids": ["agent-uuid-2"]
}
}
}
Callback Agents
Update Callback Sources
Update the list of source agents for a callback agent
PUT
/
api
/
v1
/
agents
/
{agent_id}
/
callback
curl -X PUT "https://app.talkover.ai/api/v1/agents/agent-uuid-1/callback" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-H "Content-Type: application/json" \
-d '{
"source_agent_ids": ["agent-uuid-2"]
}'
{
"success": true,
"data": {
"id": "agent-uuid-1",
"callback_config": {
"source_agent_ids": ["agent-uuid-2"]
}
}
}
Update Callback Sources
Replace the list of source agents associated with this callback agent. The provided list completely replaces the existing one.Endpoint
PUT /api/v1/agents/{agent_id}/callback
Path parameters
string
required
UUID of the callback agent.
Request headers
string
required
Bearer token. Format:
Bearer talq_your_environment_token_herestring
required
Must be set to
application/jsonRequest body
array
required
New full list of outbound agent UUIDs that should route callbacks here. Must contain at least one entry.
Examples
curl -X PUT "https://app.talkover.ai/api/v1/agents/agent-uuid-1/callback" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-H "Content-Type: application/json" \
-d '{
"source_agent_ids": ["agent-uuid-2"]
}'
Response
{
"success": true,
"data": {
"id": "agent-uuid-1",
"callback_config": {
"source_agent_ids": ["agent-uuid-2"]
}
}
}
Notes
- This is a replace operation, not append. To remove all sources but keep the callback role, send an empty array — but note that an empty array fails validation; use Remove Callback Role instead.
- To add or remove individual sources, fetch the current list with Get Callback Agent, modify it, then send the full updated list here.
Was this page helpful?