---
search:
  tags:
    - 工具
    - POST
seo:
  description: >-
    呼叫探索描述中標示 confirmation: "none" 的工具，包括讀取資料及接續已授權的上傳。依路徑中的工具名稱，使用相符結構傳送
    {input: {...}}。JSON 請求上限為 65,536…
sidebar:
  label: 呼叫不需確認的工具
  badge: POST
title: 呼叫不需確認的工具
type: openapi-operation
---
呼叫探索描述中標示 confirmation: "none" 的工具，包括讀取資料及接續已授權的上傳。依路徑中的工具名稱，使用相符結構傳送 {input: {...}}。JSON 請求上限為 65,536 位元組。200 回應仍可能包含 ok:false。

`POST /api/v1/tools/{tool}/call`

**請求主體** (`application/json`, 必要)

- `input` (object, 必要)

請求主體範例:

```json
{
  "input": {
    "property1": "string",
    "property2": "string"
  }
}
```

**回應**

- `200` — 工具結果；請檢查 ok 與 error。
- `400` — 請求無效。不接受查詢參數。工具驗證失敗可能使用工具錯誤封裝格式。
- `401` — 未提供 bearer 憑證，或憑證無效、已到期。
- `403` — 憑證缺少必要權限。
- `404` — 供程式呼叫的 API 或要求的工具無法使用。
- `413` — 請求超過位元組上限。
- `429` — 已超過速率限制。此錯誤可重試。
- `503` — API 或其上游執行環節無法使用。

回應範例, 200:

```json
{
  "ok": true,
  "output": "string",
  "toolName": "adAuditQuote"
}
```