---
search:
  tags:
    - Strumenti
    - POST
seo:
  description: >-
    Prepara una modifica con {input: {...}}. La preparazione non approva né
    esegue la pubblicazione. Una preparazione riuscita restituisce
    confirmationCapability…
sidebar:
  label: Prepara una modifica
  badge: POST
title: Prepara una modifica
type: openapi-operation
---
Prepara una modifica con {input: {...}}. La preparazione non approva né esegue la pubblicazione. Una preparazione riuscita restituisce confirmationCapability ed expiresAt; un errore dello strumento può comunque usare HTTP 200. Le richieste JSON hanno un limite di 65.536 byte.

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

**Corpo della richiesta** (`application/json`, obbligatorio)

- `input` (object, obbligatorio)

Esempio del corpo della richiesta:

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

**Risposte**

- `200` — Preparazione o errore dello strumento.
- `400` — Richiesta non valida. I parametri di query non sono accettati. Gli errori di convalida degli strumenti possono usare una struttura di risposta di errore dello strumento.
- `401` — Credenziale Bearer mancante, non valida o scaduta.
- `403` — La credenziale non dispone delle autorizzazioni richieste.
- `404` — L’API per l’accesso programmatico o lo strumento richiesto non è disponibile.
- `413` — La richiesta supera il limite in byte.
- `429` — Limite di frequenza superato. È possibile riprovare.
- `503` — L’API o il servizio di esecuzione a monte non è disponibile.

Esempio di risposta, 200:

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