Skip to main content
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

​
agent_id
string
required
UUID of the callback agent.

​
Request headers

​
Authorization
string
required
Bearer token. Format: Bearer talq_your_environment_token_here
​
Content-Type
string
required
Must be set to application/json

​
Request body

​
source_agent_ids
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.