Skip to main content
POST
/
api
/
v1
/
agents
/
{agent_id}
/
publish
curl -X POST "https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/publish" \
  -H "Authorization: Bearer talq_your_environment_token_here"

{
  "success": true,
  "message": "Agent published successfully",
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "SupportBot",
    "current_status": "published",
    "is_ready_to_publish": true,
    "updated_at": "2024-01-15T10:50:00Z"
  }
}

​
Publish Agent

Publish an agent to mark it as active. A published agent can receive inbound calls or be used to place outbound calls.

​
Endpoint

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

​
Path parameters

​
agent_id
string
required
The unique identifier of the voice agent to publish.

​
Request headers

​
Authorization
string
required
Bearer token for authentication. Format: Bearer talq_your_environment_token_here

​
Examples

curl -X POST "https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/publish" \
  -H "Authorization: Bearer talq_your_environment_token_here"

​
Response

{
  "success": true,
  "message": "Agent published successfully",
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "SupportBot",
    "current_status": "published",
    "is_ready_to_publish": true,
    "updated_at": "2024-01-15T10:50:00Z"
  }
}

​
Notes

  • The agent must be properly configured (knowledge, voice, calling settings) before it can be published. If is_ready_to_publish is false, the publish call will fail with a 422 validation error explaining what’s missing.
  • Publishing an outbound agent does not start any calls — use Make a Call to dispatch outbound calls.
  • To temporarily disable a published agent, use Unpublish Agent.