List Agent Tools

GET

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

List tools currently attached to the agent. Bare list — an agent’s tool attachment count is bounded by configuration, so this endpoint does not paginate.

Authentication

AuthorizationBearer

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

Path parameters

idstringRequired

Response

Attached tools for the agent.

toolslist of objects

Errors

401

Unauthorized Error

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

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