---
search:
  tags:
    - 도구
    - GET
seo:
  description: bearer 인증 정보에 표시되는 도구 이름, 설명, 권한 범위, 확인 요건 및 입력 스키마를 반환합니다.
sidebar:
  label: 사용 가능한 도구 검색
  badge: GET
title: 사용 가능한 도구 검색
type: openapi-operation
---
bearer 인증 정보에 표시되는 도구 이름, 설명, 권한 범위, 확인 요건 및 입력 스키마를 반환합니다.

`GET /api/v1/tools`

**응답**

- `200` — 사용 가능한 도구 설명자입니다.
- `400` — 잘못된 요청입니다. 쿼리 매개변수는 받지 않습니다. 도구 유효성 검사 실패는 도구 오류 응답 형식으로 반환될 수 있습니다.
- `401` — bearer 인증 정보가 없거나 유효하지 않거나 만료되었습니다.
- `403` — 인증 정보에 필요한 권한이 없습니다.
- `404` — 머신 API 또는 요청한 도구를 사용할 수 없습니다.
- `429` — 요청 빈도 제한을 초과했습니다. 재시도할 수 있는 오류입니다.
- `503` — API 또는 업스트림 실행을 이용할 수 없습니다.

응답 예시, 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"
}
```