---
search:
  tags:
    - Herramientas
    - POST
seo:
  description: >-
    Prepara una operación que modifica datos con {input: {...}}. La preparación
    no aprueba ni ejecuta la publicación. Si se completa, devuelve…
sidebar:
  label: Preparar una modificación
  badge: POST
title: Preparar una modificación
type: openapi-operation
---
Prepara una operación que modifica datos con {input: {...}}. La preparación no aprueba ni ejecuta la publicación. Si se completa, devuelve confirmationCapability y expiresAt; un error de herramienta también puede devolver HTTP 200. Las solicitudes JSON tienen un límite de 65536 bytes.

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

**Cuerpo de la solicitud** (`application/json`, obligatorio)

- `input` (object, obligatorio)

Ejemplo del cuerpo de la solicitud:

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

**Respuestas**

- `200` — Preparación o error de herramienta.
- `400` — Solicitud no válida. No se aceptan parámetros de consulta. Los fallos de validación pueden usar el formato de error de la herramienta.
- `401` — Credencial bearer ausente, no válida o caducada.
- `403` — Las credenciales no tienen los permisos necesarios.
- `404` — La API o la herramienta solicitada no está disponible.
- `413` — La solicitud supera el límite de bytes.
- `429` — Se ha superado el límite de solicitudes. Se puede reintentar.
- `503` — La API o el servicio que ejecuta la operación no está disponible.

Ejemplo de respuesta, 200:

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