---
search:
  tags:
    - Verktyg
    - POST
seo:
  description: >-
    Förbered en ändring med {input: {...}}. Förberedelsen varken godkänner eller
    utför publicering. En lyckad förberedelse returnerar confirmationCapability
    och…
sidebar:
  label: Förbered en ändring
  badge: POST
title: Förbered en ändring
type: openapi-operation
---
Förbered en ändring med {input: {...}}. Förberedelsen varken godkänner eller utför publicering. En lyckad förberedelse returnerar confirmationCapability och expiresAt; ett verktygsfel kan ändå returneras med HTTP 200. JSON-begäranden är begränsade till 65 536 byte.

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

**Anropskropp** (`application/json`, obligatorisk)

- `input` (object, obligatorisk)

Exempel på anropskropp:

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

**Svar**

- `200` — Förberedelse eller verktygsfel.
- `400` — Ogiltig begäran. Frågeparametrar accepteras inte. Verktygets valideringsfel kan returneras i en struktur för verktygsfel.
- `401` — Bearer-autentiseringsuppgifter saknas, är ogiltiga eller har löpt ut.
- `403` — Autentiseringsuppgifterna saknar nödvändiga behörigheter.
- `404` — Maskin-API:et eller det begärda verktyget är inte tillgängligt.
- `413` — Begäran överskrider bytegränsen.
- `429` — Anropsgränsen har överskridits. Ett nytt försök kan göras för det här felet.
- `503` — API:et är inte tillgängligt, eller så är den bakomliggande körningen inte tillgänglig.

Exempelsvar, 200:

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