---
search:
  tags:
    - Công cụ
    - POST
seo:
  description: >-
    Chuẩn bị thao tác thay đổi bằng {input: {...}}. Bước chuẩn bị không phê
    duyệt hay thực hiện việc đăng. Chuẩn bị thành công trả về
    confirmationCapability và…
sidebar:
  label: Chuẩn bị thao tác thay đổi
  badge: POST
title: Chuẩn bị thao tác thay đổi
type: openapi-operation
---
Chuẩn bị thao tác thay đổi bằng {input: {...}}. Bước chuẩn bị không phê duyệt hay thực hiện việc đăng. Chuẩn bị thành công trả về confirmationCapability và expiresAt; lỗi công cụ vẫn có thể dùng HTTP 200. Yêu cầu JSON có giới hạn 65.536 byte.

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

**Nội dung yêu cầu** (`application/json`, bắt buộc)

- `input` (object, bắt buộc)

Ví dụ nội dung yêu cầu:

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

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

- `200` — Kết quả chuẩn bị hoặc lỗi công cụ.
- `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.
- `413` — Yêu cầu vượt giới hạn byte.
- `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
{
  "confirmationCapability": "stringstringstringstringstringst",
  "expiresAt": "2019-08-24T14:15:22Z",
  "inputDigest": "string",
  "status": "confirmation_required",
  "summary": "string",
  "toolName": "adAuditQuote"
}
```