Skip to main content
DELETE
/
api
/
tools
/
{tool_id}
Delete Tool
curl --request DELETE \
  --url https://api.example.com/api/tools/{tool_id} \
  --header 'X-API-Key: <x-api-key>' \
  --header 'X-Organization-Id: <x-organization-id>'
{
  "success": true,
  "message": "Tool deleted successfully"
}
Delete a custom tool.
Cannot delete tools that are attached to agents. Detach them first.

​
Headers

​
X-API-Key
string
required
Your API key for authentication.
​
X-Organization-Id
string
required
The organization ID.

​
Path Parameters

​
tool_id
string
required
The unique identifier of the tool to delete.

​
Permissions

  • tools:delete (admin, agent_manager)

​
Response

​
success
boolean
Indicates if the deletion was successful.
​
message
string
Human-readable success message.
{
  "success": true,
  "message": "Tool deleted successfully"
}

​
Errors

​
404
object
Tool not found.
​
403
object
Tool belongs to different organization.
​
409
object
Cannot delete tool - it is attached to agents. Detach it first.