List tools

Returns the AI Agent’s tools in a single inventory, cursor-paginated, in fixed source order: api, then code. Each source is ordered by id. Replay meta.next_page_url verbatim to fetch the next page; next_page_url is null on the last or empty page.

Each item is the same Tool envelope as GET /v2/tools/{tool_id}, without the type body (api / code). HTTP details and source code belong on a single-tool fetch.

type skips the excluded sources entirely rather than filtering after the query. enabled filters on the tool’s own enabled flag — the same field returned on each item — for every type.

A cursor is bound to the Agent that minted it and to the type / enabled filters in effect. Changing those filters, or presenting another Agent’s cursor, returns 400.

Returns the AI Agent's tools in a single inventory, cursor-paginated, in fixed source order: `api`, then `code`. Each source is ordered by id. Replay `meta.next_page_url` verbatim to fetch the next page; `next_page_url` is `null` on the last or empty page. Each item is the same `Tool` envelope as `GET /v2/tools/{tool_id}`, without the type body (`api` / `code`). HTTP details and source code belong on a single-tool fetch. `type` skips the excluded sources entirely rather than filtering after the query. `enabled` filters on the tool's own `enabled` flag — the same field returned on each item — for every type. A cursor is bound to the Agent that minted it and to the `type` / `enabled` filters in effect. Changing those filters, or presenting another Agent's cursor, returns `400`.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

typeenumOptional

Restrict the list to one tool type. Omitted sources are not queried.

Allowed values:

enabledbooleanOptional

Filter on the tool’s own enabled flag. Same meaning for api and code: the stored per-tool toggle.

limitintegerOptional1-100Defaults to 25

Maximum tools per page. Default 25. Out-of-range values return 400.

cursorstringOptional

Opaque pagination cursor from a previous response’s meta.next_page_url. Treat it as an opaque token, not an id. Replay the returned next_page_url unchanged.

Response

A page of tools

datalist of objects

The page of tools

metaobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error

500

Internal Server Error

Each item is the same Tool envelope as GET /v2/tools/{tool_id}, without the type body (api / code). HTTP details and source code belong on a single-tool fetch.

type skips the excluded sources entirely rather than filtering after the query. enabled filters on the tool’s own enabled flag — the same field returned on each item — for every type.

A cursor is bound to the Agent that minted it and to the type / enabled filters in effect. Changing those filters, or presenting another Agent’s cursor, returns 400.

1	import requests
2
3	url = "https://example.ada.support/api/v2/tools/"
4
5	headers = {"Authorization": "Bearer <token>"}
6
7	response = requests.get(url, headers=headers)
8
9	print(response.json())

1	{
2	"data": [
3	{
4	"id": "507f1f77bcf86cd799439011",
5	"type": "api",
6	"name": "get_order_status",
7	"description": "Look up the status of a customer's order",
8	"inputs": [],
9	"outputs": [],
10	"enabled": true,
11	"direct_use": true,
12	"availability": null
13	}
14	],
15	"meta": {
16	"next_page_url": null
17	}
18	}