Tools

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.

get/v2/tools/

Request

  • Base URL: https://example.ada.support/api
  • URL: https://example.ada.support/api/v2/tools/
  • Auth: HTTP bearer

Query parameters

type'api' | 'code'

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

enabledboolean

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

limitinteger

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

cursorstring

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

Changes

No recorded changes to this operation across all 1 revision of this API.