---
search:
  tags:
    - Ferramentas
    - POST
seo:
  description: >-
    Prepare uma alteração com {input: {...}}. A preparação não aprova nem
    executa a publicação. Uma preparação bem-sucedida retorna
    confirmationCapability e…
sidebar:
  label: Preparar uma alteração
  badge: POST
title: Preparar uma alteração
type: openapi-operation
---
Prepare uma alteração com {input: {...}}. A preparação não aprova nem executa a publicação. Uma preparação bem-sucedida retorna confirmationCapability e expiresAt; uma falha da ferramenta ainda pode usar HTTP 200. Solicitações JSON têm limite de 65.536 bytes.

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

**Corpo da solicitação** (`application/json`, obrigatório)

- `input` (object, obrigatório)

Exemplo de corpo da solicitação:

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

**Respostas**

- `200` — Preparação ou falha da ferramenta.
- `400` — Solicitação inválida. Parâmetros de consulta não são aceitos. Falhas de validação da ferramenta podem usar a estrutura de erro da ferramenta.
- `401` — Credencial bearer ausente, inválida ou expirada.
- `403` — A credencial não tem as permissões necessárias.
- `404` — A API para automações ou a ferramenta solicitada está indisponível.
- `413` — A solicitação excede o limite de bytes.
- `429` — Limite de solicitações excedido. É possível tentar novamente após este erro.
- `503` — A API ou o serviço responsável pela execução está indisponível.

Exemplo de resposta, 200:

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