Skip to main content
POST
/
api
/
v1
/
agents
/
{agent_id}
/
callback
curl -X POST "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", "agent-uuid-3"]
  }'

{
  "success": true,
  "data": {
    "id": "agent-uuid-1",
    "name": "Callback Handler",
    "direction": "inbound",
    "callback_config": {
      "source_agent_ids": ["agent-uuid-2", "agent-uuid-3"]
    }
  }
}

​
Set Agent as Callback

Configure an inbound agent to handle callbacks from one or more outbound source agents. When a contact previously called by a source agent dials back, the call is routed to this agent (assuming the agent owns the dialed number).

​
Endpoint

POST /api/v1/agents/{agent_id}/callback

​
Path parameters

​
agent_id
string
required
UUID of the inbound agent. Must have direction: "inbound".

​
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
Array of outbound agent UUIDs whose contacts should route to this callback agent on inbound returns. Must contain at least one entry.

​
Examples

curl -X POST "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", "agent-uuid-3"]
  }'

​
Response

{
  "success": true,
  "data": {
    "id": "agent-uuid-1",
    "name": "Callback Handler",
    "direction": "inbound",
    "callback_config": {
      "source_agent_ids": ["agent-uuid-2", "agent-uuid-3"]
    }
  }
}

​
Error responses

​
422 — Wrong Direction

{
  "success": false,
  "message": "Agent must have direction=inbound to serve as a callback",
  "code": "INVALID_AGENT_DIRECTION"
}