---
search:
  tags:
    - Tools
    - POST
seo:
  description: >-
    Bereite mit {input: {...}} eine Änderung vor. Die Vorbereitung genehmigt
    oder veröffentlicht nichts. Bei Erfolg werden confirmationCapability und
    expiresAt…
sidebar:
  label: Änderung vorbereiten
  badge: POST
title: Änderung vorbereiten
type: openapi-operation
---
Bereite mit {input: {...}} eine Änderung vor. Die Vorbereitung genehmigt oder veröffentlicht nichts. Bei Erfolg werden confirmationCapability und expiresAt zurückgegeben; auch ein Tool-Fehler kann HTTP 200 verwenden. JSON-Anfragen sind auf 65536 Bytes begrenzt.

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

**Anfrageinhalt** (`application/json`, erforderlich)

- `input` (object, erforderlich)

Beispiel für den Anfrageinhalt:

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

**Antworten**

- `200` — Vorbereitung oder Tool-Fehler.
- `400` — Ungültige Anfrage. Abfrageparameter werden nicht akzeptiert. Validierungsfehler können im Fehlerformat des Tools zurückgegeben werden.
- `401` — Bearer-Zugangsdaten fehlen, sind ungültig oder abgelaufen.
- `403` — Den Zugangsdaten fehlen erforderliche Berechtigungen.
- `404` — Die API oder das angeforderte Tool ist nicht verfügbar.
- `413` — Die Anfrage überschreitet das Byte-Limit.
- `429` — Anfragelimit überschritten. Ein erneuter Versuch ist möglich.
- `503` — Die API oder der ausführende Dienst ist nicht verfügbar.

Antwortbeispiel, 200:

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