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

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

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.

​
Unpublish Agent

Unpublish an agent to revert it to draft state. The agent stops receiving inbound calls and cannot be used for outbound calls until published again.

​
Endpoint

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

​
Path Parameters

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

​
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/unpublish" \
  -H "Authorization: Bearer talq_your_environment_token_here"

​
Response

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

​
Notes

  • Unpublishing does not delete any data — the agent’s knowledge, voice, trainings, actions, and phone numbers are preserved.
  • Active calls that started before the unpublish are not interrupted. Only new calls are blocked.
  • To permanently delete an agent, use Delete Agent.