---
search:
  tags:
    - Инструменты
    - POST
seo:
  description: >-
    Подготовьте изменение с помощью {input: {...}}. Подготовка не одобряет и не
    выполняет публикацию. При успешной подготовке возвращаются
    confirmationCapability…
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"
}
```