Voice agentsAgent tools

Update tool

Updates only the fields you send.

PATCH/v2/tools/{id}

config and credentials are replaced as a whole -- send the complete object, not just the keys that changed.

Authorization

Authorizationstringheaderrequired
Bearer authentication header of the form Bearer <api_key>, where <api_key> is a key from Account Settings → API keys in your dashboard.

Path parameters

idstring (uuid)required
The tool's id.

Request body

application/json

is_enabledboolean
Turn the tool on or off.
configobject
New tool settings.
credentialsobject
New secrets.
channelstring
Move the tool to the other channel.
Allowed:telephonywhatsapp

Response

The updated tool object.

Show all 9 fieldsHide fields

idstring (uuid)
Unique identifier of the tool.
agent_idstring (uuid)
Agent the tool belongs to.
tool_typestring
Built-in type (call_transfer, cal_com_booking, knowledge_base, media_attachment, static_response, whatsapp_template) or, for a custom tool, its task name.
is_enabledboolean
Whether the agent may use the tool.
configobject
Tool settings. The shape depends on tool_type.
has_credentialsboolean
Whether secret credentials are stored. Credentials are never returned.
channelstring
telephony for the voice agent, whatsapp for the WhatsApp text agent.
Allowed:telephonywhatsapp
created_atstring (date-time)
When the tool was created.
updated_atstring (date-time)
When the tool was last changed.

curl --request PATCH \ --url 'https://api.tarangnow.com/v2/tools/b7e1c2d3-4f5a-4b6c-9d7e-8f9a0b1c2d3e' \ --header 'Authorization: Bearer <api_key>' \ --header 'Content-Type: application/json' \ --data '{ "is_enabled": false }'

{ "id": "b7e1c2d3-4f5a-4b6c-9d7e-8f9a0b1c2d3e", "agent_id": "3f6c2b1e-8a4d-4c5e-9b2a-1d7e6f8a9b0c", "tool_type": "check_order_status", "is_enabled": false, "config": { "name": "check_order_status", "description": "Look up the status of a customer's order by order id.", "pre_call_message": "One moment while I check that for you.", "parameters": { "type": "object", "properties": { "order_id": { "type": "string", "description": "The customer's order id" } }, "required": [ "order_id" ] }, "method": "GET", "url": "https://api.example.com/orders/{order_id}", "param": {}, "headers": {} }, "has_credentials": true, "channel": "telephony", "created_at": "2026-10-20T09:15:42.120Z", "updated_at": "2026-10-24T14:03:11.508Z" }

Response

The updated tool object.

Show all 9 fieldsHide fields

idstring (uuid)
Unique identifier of the tool.
agent_idstring (uuid)
Agent the tool belongs to.
tool_typestring
Built-in type (call_transfer, cal_com_booking, knowledge_base, media_attachment, static_response, whatsapp_template) or, for a custom tool, its task name.
is_enabledboolean
Whether the agent may use the tool.
configobject
Tool settings. The shape depends on tool_type.
has_credentialsboolean
Whether secret credentials are stored. Credentials are never returned.
channelstring
telephony for the voice agent, whatsapp for the WhatsApp text agent.
Allowed:telephonywhatsapp
created_atstring (date-time)
When the tool was created.
updated_atstring (date-time)
When the tool was last changed.