List Client Tools

GET /client-tools List the client’s reusable tool catalog. A catalog tool can be assigned to multiple agents with Assign Tool to Workflow, where it inherits and stays in sync with the catalog row. For a tool that should live in a single agent only, see Create Workflow Tool instead.

Responses

`200` — Successful response

{
  "success": true,
  "tools": [
    {
      "id": "7c1b2c3d-0000-4000-8000-000000000002",
      "client_id": "3f9a1111-0000-4000-8000-000000000099",
      "name": "check_subscription",
      "description": "Checks whether the lead has an active subscription",
      "url": "https://api.acme.com/subscriptions/status",
      "method": "GET",
      "timeout_ms": 10000,
      "parameters": { "type": "object", "properties": {} },
      "headers": {},
      "query_parameters": {},
      "speak_during_execution": true,
      "speak_after_execution": true,
      "response_variables": {},
      "is_active": true,
      "sort_order": 0,
      "execution_message_type": null,
      "execution_message_description": null,
      "llm_response_fields": null,
      "created_at": "2026-07-15T12:00:00.000Z",
      "updated_at": "2026-07-15T12:00:00.000Z"
    }
  ]
}

Response Fields — ClientTool

Field	Type	Description
`id`	string (uuid)	Tool identifier
`client_id`	string (uuid)	Your client identifier
`name`	string	snake_case name the agent references when calling the tool. Immutable
`description`	string	Tells the agent what the tool does and when to use it. Max 1024 characters
`url`	string	Endpoint the tool calls
`method`	string	HTTP method: `GET`, `POST`, `PUT`, `PATCH`, or `DELETE`
`timeout_ms`	integer	Clamped to 1,000–120,000
`parameters`	object	JSON-schema-style object describing the tool’s call arguments
`headers`	object	Static headers sent with every call
`query_parameters`	object	Static query string params sent with every call
`speak_during_execution`	boolean	Have the voice agent speak while the call is in flight
`speak_after_execution`	boolean	Have the voice agent speak once the call returns
`response_variables`	object	Map of response fields to capture as call variables
`is_active`	boolean	Whether the agent can currently call this tool
`sort_order`	integer	Display order
`execution_message_type`	string \| null	e.g. `"prompt"`
`execution_message_description`	string \| null	What the agent says during/after execution
`llm_response_fields`	string[] \| null	Allowlist of response fields the agent sees
`created_at`	string (date-time)	Creation timestamp
`updated_at`	string (date-time)	Last update timestamp

`401` — Authentication error

See Authentication.

`500` — Internal server error

Last modified on July 15, 2026

Set Stage Gate

Create Client Tool

​Responses

​200 — Successful response

​Response Fields — ClientTool

​401 — Authentication error

​500 — Internal server error

Responses

`200` — Successful response

Response Fields — ClientTool

`401` — Authentication error

`500` — Internal server error