---
search:
  tags:
    - Outils
    - POST
seo:
  description: >-
    Préparez une modification avec {input: {...}}. Cette étape n’approuve ni
    n’effectue la publication. En cas de réussite, elle renvoie
    confirmationCapability et…
sidebar:
  label: Préparer une modification
  badge: POST
title: Préparer une modification
type: openapi-operation
---
Préparez une modification avec {input: {...}}. Cette étape n’approuve ni n’effectue la publication. En cas de réussite, elle renvoie confirmationCapability et expiresAt ; une erreur d’outil peut aussi renvoyer HTTP 200. Les requêtes JSON sont limitées à 65536 octets.

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

**Corps de la requête** (`application/json`, obligatoire)

- `input` (object, obligatoire)

Exemple de corps de requête:

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

**Réponses**

- `200` — Préparation ou erreur d’outil.
- `400` — Requête non valide. Les paramètres de requête sont refusés. Les erreurs de validation peuvent utiliser l’enveloppe d’erreur d’un outil.
- `401` — Identifiant bearer absent, non valide ou expiré.
- `403` — Les identifiants ne disposent pas des autorisations requises.
- `404` — L’API ou l’outil demandé est indisponible.
- `413` — La requête dépasse la limite en octets.
- `429` — Limite de requêtes dépassée. Une nouvelle tentative est possible.
- `503` — L’API ou le service chargé de l’exécution est indisponible.

Exemple de réponse, 200:

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