Delete Tool

Delete a tool from an agent.

HTTP Request

$DELETE https://app.resemble.ai/api/v2/agents/{agent_uuid}/tools/{id}

URL Parameters

ParameterTypeDescription
agent_uuidstringThe agent’s UUID
idintegerThe tool ID

Example Request

$curl --request DELETE "https://app.resemble.ai/api/v2/agents/550e8400-e29b-41d4-a716-446655440000/tools/1" \
> -H "Authorization: Bearer YOUR_API_TOKEN" \
> -H "Content-Type: application/json"

Response (Success)

1{
2 "success": true,
3 "message": "Tool deleted successfully"
4}

Response (System Tool Error)

1{
2 "success": false,
3 "errors": {
4 "base": ["System tools cannot be deleted"]
5 },
6 "message": "Cannot delete system tool"
7}

Validation Rules

  • System tools cannot be deleted (they can only be disabled via update)
  • Only webhook and client tools can be deleted
  • Deletion is permanent and cannot be undone

See Also