Skip to navigation

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.

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