> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.ada.cx/release-notes/2026/8/21/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ada.cx/_mcp/server.

# Tools API is available

The [Tools API](/reference/tools/overview) is a single inventory of the HTTP tools (`api`) and code tools (`code`) configured on an AI Agent. List, fetch, create, update, and delete tools through one Platform API.

## API endpoints

The following REST endpoints are available:

* **List tools** (`GET /v2/tools/`): Returns the Agent's tools in cursor-paginated pages, in source order `api`, then `code`. Filter with `type` and `enabled`. Replay `meta.next_page_url` unchanged to fetch the next page.
* **Get a tool** (`GET /v2/tools/{tool_id}`): Returns a single tool by its `id`, including the type-specific body (`api` or `code`). `Authorization` headers are never returned.
* **Create a tool** (`POST /v2/tools/`): Creates an `api` or `code` tool.
* **Update a tool** (`PATCH /v2/tools/{tool_id}`): Partially updates a tool. `api` and `code` tools accept contract, control, and implementation writes.
* **Delete a tool** (`DELETE /v2/tools/{tool_id}`): Soft-deletes an `api` or `code` tool.

List items use the same Tool envelope as GET-by-id without the type body. HTTP details and source code belong on a single-tool fetch.

`code.environment` supports `source=sensitive_value`. That value is write-only. GET returns it empty.

## Get started

* [Tools API reference](/reference/tools/overview) for authentication, pagination, filters, and the PATCH write matrix.