---
search:
  tags:
    - 工具
    - POST
seo:
  description: >-
    以 {input: {...}} 準備變更操作。準備不會核准或執行發布。準備成功時，會傳回 confirmationCapability 與
    expiresAt；工具失敗仍可能使用 HTTP 200。JSON 請求上限為…
sidebar:
  label: 準備變更操作
  badge: POST
title: 準備變更操作
type: openapi-operation
---
以 {input: {...}} 準備變更操作。準備不會核准或執行發布。準備成功時，會傳回 confirmationCapability 與 expiresAt；工具失敗仍可能使用 HTTP 200。JSON 請求上限為 65,536 位元組。

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

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

- `input` (object, 必要)

請求主體範例:

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

**回應**

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

回應範例, 200:

```json
{
  "confirmationCapability": "stringstringstringstringstringst",
  "expiresAt": "2019-08-24T14:15:22Z",
  "inputDigest": "string",
  "status": "confirmation_required",
  "summary": "string",
  "toolName": "adAuditQuote"
}
```