Skip to main content
POST
/
api
/
v1
/
callback-agents
/
{agent_id}
/
check-constraints
curl -X POST "https://app.talkover.ai/api/v1/callback-agents/agent-uuid-1/check-constraints" \
  -H "Authorization: Bearer talq_your_environment_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "is_callback_agent": true,
    "callback_source_agents": ["agent-uuid-2", "agent-uuid-3"],
    "callback_trigger_statuses": ["no_answer", "voicemail", "busy"]
  }'
{
  "success": true,
  "message": "Configuration is valid"
}

Documentation Index

Fetch the complete documentation index at: https://docs.talkover.ai/llms.txt

Use this file to discover all available pages before exploring further.

Check Callback Constraints

Validate a proposed callback configuration without persisting changes. Useful to surface errors in the UI before submitting Set Agent as Callback or Update Callback Sources.

Endpoint

POST /api/v1/callback-agents/{agent_id}/check-constraints

Path Parameters

agent_id
string
required
Agent UUID being configured as callback.

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

is_callback_agent
boolean
Whether this agent should be marked as a callback agent.
callback_source_agents
array
Array of source agent UUIDs.
callback_trigger_statuses
array
Statuses of source-agent calls that make a contact eligible for callback (e.g., ["no_answer", "voicemail"]).

Examples

curl -X POST "https://app.talkover.ai/api/v1/callback-agents/agent-uuid-1/check-constraints" \
  -H "Authorization: Bearer talq_your_environment_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "is_callback_agent": true,
    "callback_source_agents": ["agent-uuid-2", "agent-uuid-3"],
    "callback_trigger_statuses": ["no_answer", "voicemail", "busy"]
  }'

Response

Valid

{
  "success": true,
  "message": "Configuration is valid"
}

Invalid

{
  "success": false,
  "message": "Configuration has errors",
  "errors": [
    "Agent must be inbound to serve as a callback agent",
    "Source agent agent-uuid-3 is not published"
  ]
}