---
search:
  tags:
    - Tools
    - GET
seo:
  description: >-
    Return tool names, descriptions, scopes, confirmation requirements and input
    schemas visible to the bearer credential.
sidebar:
  label: Discover available tools
  badge: GET
title: Discover available tools
type: openapi-operation
---
Return tool names, descriptions, scopes, confirmation requirements and input schemas visible to the bearer credential.

`GET /api/v1/tools`

**Responses**

- `200` — Available tool descriptors.
- `400` — Invalid request. Query parameters are not accepted. Tool validation failures may use a tool error envelope.
- `401` — Missing, invalid or expired bearer credential.
- `403` — The credential lacks required permissions.
- `404` — The machine API or requested tool is unavailable.
- `429` — Rate limit exceeded. The error is retryable.
- `503` — The API or its upstream execution is unavailable.

Response example, 200:

```json
{
  "tools": [
    {
      "annotations": {
        "destructiveHint": true,
        "idempotentHint": true,
        "openWorldHint": true,
        "readOnlyHint": true
      },
      "confirmation": "none",
      "description": "string",
      "gate": "core",
      "mutability": "read",
      "name": "adAuditQuote",
      "scopes": [
        "integrations:read"
      ],
      "title": "string",
      "inputSchema": {
        "type": "object",
        "property1": "string",
        "property2": "string"
      },
      "property1": "string",
      "property2": "string"
    }
  ],
  "property1": "string",
  "property2": "string"
}
```