> ## Documentation Index
> Fetch the complete documentation index at: https://wondeya.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Idempotencia

> Reintenta una creación de forma segura con un Idempotency-Key

Los reintentos de red ocurren (una solicitud expira, una función se vuelve a ejecutar), y un reintento a ciegas de una creación crea un segundo agente, o gasta un segundo crédito de chat. Un **`Idempotency-Key`** hace que un reintento repita la primera respuesta en su lugar.

## Úsalo

Envía cualquier cadena única en cualquier `POST` bajo `/v1`; todos lo respetan (creaciones, publicar y despublicar, adiciones de conocimiento, fusiones de temas, subidas de recursos, el turno de chat en JSON):

```bash theme={null}
curl -X POST $WDY/agents \
  -H "Authorization: Bearer $WDY_KEY" \
  -H "Idempotency-Key: a1b2c3-create-support" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Support" }'
```

Reintenta con la MISMA clave y el MISMO cuerpo, y recibirás de vuelta la primera respuesta, sin cambios, con:

```http theme={null}
Idempotent-Replayed: true
```

No se crea un segundo agente, ni se gasta un segundo crédito.

## Las reglas

| Situación | Resultado |
| - | - |
| Misma clave, mismo cuerpo | Se repite la primera respuesta (`Idempotent-Replayed: true`). |
| Misma clave, cuerpo **distinto** | `422` `wondeya.idempotency.conflict`: una clave nombra una sola solicitud. |
| Misma clave mientras la primera aún se ejecuta | `409`. |
| La primera solicitud falló | No se guarda; reintenta con la misma clave sin problema. |

Una clave está acotada a tu clave de API y se conserva durante 24 horas. Se respeta en el modo de chat en JSON; un turno en streaming (SSE) no se puede repetir, así que ahí la clave se ignora.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.