curl -X POST "https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/unpublish" \
-H "Authorization: Bearer talq_your_environment_token_here"
const response = await fetch('https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/unpublish', {
method: 'POST',
headers: {
'Authorization': 'Bearer talq_your_environment_token_here'
}
});
const result = await response.json();
import requests
url = "https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/unpublish"
headers = {"Authorization": "Bearer talq_your_environment_token_here"}
response = requests.post(url, headers=headers)
result = response.json()
{
"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"
}
}
Agents
Unpublish Agent
Unpublish an agent to take it offline without deleting it
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"
const response = await fetch('https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/unpublish', {
method: 'POST',
headers: {
'Authorization': 'Bearer talq_your_environment_token_here'
}
});
const result = await response.json();
import requests
url = "https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/unpublish"
headers = {"Authorization": "Bearer talq_your_environment_token_here"}
response = requests.post(url, headers=headers)
result = response.json()
{
"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"
}
}
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
string
required
The unique identifier of the voice agent to unpublish.
Request headers
string
required
Bearer token for authentication. Format:
Bearer talq_your_environment_token_hereExamples
curl -X POST "https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/unpublish" \
-H "Authorization: Bearer talq_your_environment_token_here"
const response = await fetch('https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/unpublish', {
method: 'POST',
headers: {
'Authorization': 'Bearer talq_your_environment_token_here'
}
});
const result = await response.json();
import requests
url = "https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/unpublish"
headers = {"Authorization": "Bearer talq_your_environment_token_here"}
response = requests.post(url, headers=headers)
result = response.json()
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.
Was this page helpful?