Voice agentsAgent tools

List an agent's tools

Returns the tools of one agent.

GET/v2/agents/{agent_id}/tools

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

agent_idstring (uuid)required
The agent's id.

Query parameters

channelstring
Only tools for this channel. Omit for both.
Allowed:telephonywhatsapp

Response

An array of tool objects. Each item is described in the tool object.

Request

curl --request GET \
  --url 'https://api.tarangnow.com/v2/agents/3f6c2b1e-8a4d-4c5e-9b2a-1d7e6f8a9b0c/tools' \
  --header 'Authorization: Bearer <api_key>'

Response

[
  {
    "id": "b7e1c2d3-4f5a-4b6c-9d7e-8f9a0b1c2d3e",
    "agent_id": "3f6c2b1e-8a4d-4c5e-9b2a-1d7e6f8a9b0c",
    "tool_type": "check_order_status",
    "is_enabled": true,
    "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"
  }
]