Edit & Delete Agent

Update or permanently delete voice agents.

Update Agent

Endpoint

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
`prompt_text`	string	No	Updated prompt text
`voice_id`	integer	No	Voice library ID
`status`	string	No	Agent status (e.g. `active`)

Example request

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

Success response (200)

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

Error responses

{
  "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

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

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

Success response (200)

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

Error responses

{
  "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