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