List Agent Tools

Beta

GET

https://api.speechify.ai/v1/agents/:agent_id/tools

GET

/v1/agents/:agent_id/tools

$ curl https://api.speechify.ai/v1/agents/agent_01jqr8x9zg5k2m3n4p5q6r7s8t/tools \
>      -H "Authorization: Bearer <token>"

1 {
2   "next_cursor": "string",
3   "has_more": true,
4   "tools": [
5     {
6       "id": "tool_01kb9kefcacry5t3662gfsgtzj",
7       "kind": "builtin",
8       "name": "string",
9       "description": "string",
10       "enabled": true,
11       "definition_id": "string",
12       "config": {
13         "builtin": "string",
14         "builtin_config": {},
15         "params": [
16           {
17             "description": "string",
18             "enum": [
19               "string"
20             ],
21             "name": "string",
22             "required": true,
23             "type": "string"
24           }
25         ]
26       },
27       "created_at": "2024-01-15T09:30:00Z",
28       "updated_at": "2024-01-15T09:30:00Z",
29       "webhook_secret": "string"
30     }
31   ]
32 }

List everything this agent can do: built-in capabilities and attached external tool definitions (webhook / client / MCP) in one mixed-kind list. Each item carries its resolved config inline. Cursor-paginated: omit cursor for the first page; walk pages while has_more is true (default page size 50, max 200).

Authentication

AuthorizationBearer

Enter your API key with the Bearer prefix, e.g. ‘Bearer sk_…’.

Path parameters

agent_idstringRequired

Agent id (prefixed external id, agent_...).

Query parameters

cursorstringOptional

Opaque pagination cursor from a previous response.

limitintegerOptional1-200Defaults to 50

Max items per page (default 50, max 200).

Response headers

X-Request-IDstring

Unique identifier for this request, present on every response (2xx and non-2xx alike). If the caller sends an X-Request-ID request header the server echoes it back (sanitized and length-capped) so one logical request can be traced end-to-end; otherwise the server generates a fresh value. Log it on every response and quote it in support requests - it is the stable handle that ties your observation to Speechify’s server-side logs, and it matches the request_id field in the error envelope.

Unique identifier for this request, present on every response (2xx and non-2xx alike). If the caller sends an `X-Request-ID` request header the server echoes it back (sanitized and length-capped) so one logical request can be traced end-to-end; otherwise the server generates a fresh value. Log it on every response and quote it in support requests - it is the stable handle that ties your observation to Speechify's server-side logs, and it matches the `request_id` field in the error envelope.

Response

The agent's tools.

next_cursorstring or null

Opaque keyset cursor for the next page. Pass back as the cursor request parameter. null when the caller has reached the end of the list (has_more is also false in that case).

has_moreboolean

True when more rows exist beyond this page.

toolslist of objects

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error