Delete Tool

Delete a tool from an agent.

HTTP Request

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

URL Parameters

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

• Update Tool - Disable system tools instead of deleting
• Create Tool - Create new tools
• Get System Tools - View available system tools