Developer
⌘K
Dashboard
Agents POST

Edit & Delete Agent

Update or delete existing voice agents.

Endpoint
https://www.tabbly.io/api/update-agent

Edit & Delete Agent

Updates an agent’s settings, or permanently deletes an agent.

Update Agent

Endpoint

http
POST https://www.tabbly.io/api/update-agent

Also accepts PUT.

Authentication

See Introduction. This is a POST endpoint — include api_key in the JSON request body.

Request body

Parameter Type Required Description
api_key string Yes Your organization API key
agent_id integer Yes ID of the agent to update
agent_name string No Updated agent name
custom_first_line string No Updated greeting
prompt_text string No Updated prompt text
voice_id integer No Voice library ID
phone_number string No E.164 number — must belong to your org
stt_language string No Speech-to-text language code
status string No Agent status (e.g. active)
agent_type string No Leave empty for a normal voice agent. Use video only for video agents

Additional fields such as enable_calendar_booking, background_music, and api_tools are also accepted when provided.

Example request

bash
curl -X POST "https://www.tabbly.io/api/update-agent" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_API_KEY",
    "agent_id": 6355,
    "agent_name": "Updated Agent Name",
    "prompt_text": "Updated prompt text",
    "voice_id": 125,
    "status": "active"
  }'

Response

Success (200)

json
{
  "status": "success",
  "data": {
    "agent_id": 6355,
    "message": "Voice agent updated successfully"
  }
}

Error responses

json
{
  "status": "error",
  "message": "Human-readable error description"
}
HTTP status When
400 Missing agent_id or invalid fields
401 Missing or invalid API key
404 Agent not found or not owned by your organization
405 Method not POST or PUT

Delete Agent

Endpoint

http
POST https://www.tabbly.io/api/delete-agent

Also accepts DELETE.

Authentication

See Introduction. This is a POST endpoint — include api_key in the JSON request body.

Request body

Parameter Type Required Description
api_key string Yes Your organization API key
agent_id integer Yes ID of the agent to delete

Example request

bash
curl -X POST "https://www.tabbly.io/api/delete-agent" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_API_KEY",
    "agent_id": 6355
  }'

Response

Success (200)

json
{
  "status": "success",
  "data": {
    "agent_id": 6355,
    "agent_name": "My Voice Agent",
    "message": "Voice agent deleted successfully"
  }
}

Error responses

json
{
  "status": "error",
  "message": "Human-readable error description"
}
HTTP status When
400 Missing agent_id
401 Missing or invalid API key
404 Agent not found or not owned by your organization
405 Method not POST or DELETE