DELETE
/
delete-agent
/
{id}
curl -X DELETE 'https://api.buildr.bot/delete-agent/12345' \
  -H 'Authorization: Bearer YOUR_API_KEY'

{
  "success": true,
  "message": "Agent deleted successfully"
}

Delete an existing Buildr AI agent by its ID. This action is irreversible - once an agent is deleted, all its configurations and history will be removed.

​
Path Parameters

​
id
integer
required

The unique identifier of the agent to delete

​
Response

​
success
boolean

Indicates if the deletion was successful

​
message
string

A message describing the result of the operation

​
Error Codes

​
404
object

Returned when the specified agent ID is not found

​
400
object

Returned when the request is invalid (e.g., missing or invalid ID)

curl -X DELETE 'https://api.buildr.bot/delete-agent/12345' \
  -H 'Authorization: Bearer YOUR_API_KEY'

{
  "success": true,
  "message": "Agent deleted successfully"
}