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"]
    }
  }
}

POST

api

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

string

required

UUID of the inbound agent. Must have direction: "inbound".

Request headers

string

required

Bearer token. Format: Bearer talq_your_environment_token_here

string

required

Must be set to application/json

Request body

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"
}

Get Started

Concepts

API Reference

Guides

Set Agent as Callback

Set Agent as Callback

Endpoint

Path parameters

Request headers

Request body

Examples

Response

Error responses

422 — Wrong Direction

​Set Agent as Callback

​Endpoint

​Path parameters

​Request headers

​Request body

​Examples

​Response

​Error responses

​422 — Wrong Direction

Set Agent as Callback

Endpoint

Path parameters

Request headers

Request body

Examples

Response

Error responses

422 — Wrong Direction