---
search:
  tags:
    - Alat
    - POST
seo:
  description: >-
    Sediakan perubahan dengan {input: {...}}. Penyediaan tidak meluluskan atau
    menjalankan penerbitan. Jika berjaya, respons mengandungi
    confirmationCapability…
sidebar:
  label: Sediakan perubahan
  badge: POST
title: Sediakan perubahan
type: openapi-operation
---
Sediakan perubahan dengan {input: {...}}. Penyediaan tidak meluluskan atau menjalankan penerbitan. Jika berjaya, respons mengandungi confirmationCapability dan expiresAt; ralat alat juga boleh menggunakan HTTP 200. Permintaan JSON dihadkan kepada 65536 bait.

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

**Badan permintaan** (`application/json`, wajib)

- `input` (object, wajib)

Contoh badan permintaan:

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

**Respons**

- `200` — Penyediaan atau ralat alat.
- `400` — Permintaan tidak sah. Parameter pertanyaan tidak diterima. Kegagalan pengesahan input boleh menggunakan format ralat alat.
- `401` — Kelayakan bearer tiada, tidak sah atau telah tamat tempoh.
- `403` — Kelayakan akses tidak mempunyai kebenaran yang diperlukan.
- `404` — API atau alat yang diminta tidak tersedia.
- `413` — Permintaan melebihi had bait.
- `429` — Had permintaan telah dilampaui. Permintaan boleh dicuba semula.
- `503` — API atau perkhidmatan yang menjalankan operasi tidak tersedia.

Contoh respons, 200:

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