---
search:
  tags:
    - Công cụ
    - GET
seo:
  description: >-
    Trả về tên, mô tả, phạm vi quyền, yêu cầu xác nhận và lược đồ đầu vào của
    các công cụ mà thông tin xác thực Bearer được phép thấy.
sidebar:
  label: Khám phá công cụ khả dụng
  badge: GET
title: Khám phá công cụ khả dụng
type: openapi-operation
---
Trả về tên, mô tả, phạm vi quyền, yêu cầu xác nhận và lược đồ đầu vào của các công cụ mà thông tin xác thực Bearer được phép thấy.

`GET /api/v1/tools`

**Các phản hồi**

- `200` — Bộ mô tả các công cụ khả dụng.
- `400` — Yêu cầu không hợp lệ. Không chấp nhận tham số truy vấn. Lỗi kiểm tra dữ liệu của công cụ có thể dùng cấu trúc phản hồi lỗi của công cụ.
- `401` — Thông tin xác thực Bearer bị thiếu, không hợp lệ hoặc hết hạn.
- `403` — Thông tin xác thực thiếu các quyền cần thiết.
- `404` — API dành cho máy hoặc công cụ được yêu cầu không khả dụng.
- `429` — Vượt giới hạn tần suất. Có thể thử lại khi gặp lỗi này.
- `503` — API hoặc quá trình thực thi phía sau API không khả dụng.

Ví dụ phản hồi, 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"
}
```