# Idempotencia y duplicados

Los agentes reintentan: un timeout, una respuesta perdida, un paso que se vuelve a ejecutar. Dos herramientas evitan que un reintento publique dos veces.

## Idempotency-Key

Envía `Idempotency-Key: <valor único>` (un UUID, o un id de tu sistema; hasta 255 caracteres) en `POST /v1/posts`, `POST /v1/connect`, `POST /v1/media` (JSON), `POST /v1/partner/workspaces`.

```
curl -X POST https://wyroapi.com/v1/posts \
  -H "Authorization: Bearer $WYRO_API_KEY" \
  -H "Idempotency-Key: 6f1c2a9e-3b7d-4c55-9e1a-0d2b8f4a7c11" \
  -H "Content-Type: application/json" \
  -d '{"text": "…", "platforms": ["instagram"], "media": [{"url": "https://…/a.jpg"}]}'
```

- La **misma clave con el mismo body** desde el mismo espacio de trabajo (o partner) dentro de **24 h** devuelve la **primera respuesta** (mismo status y body) sin hacer el trabajo otra vez. Viene con el header `Idempotent-Replayed: true`.
- La **misma clave con otro body** responde `409 idempotency_conflict`. Si la primera solicitud todavía se está procesando, también 409, con `details.reason: "in_progress"`: espera un segundo y reintenta.
- Las respuestas que significan "reintenta" (`429` y `5xx`) no se guardan: reintentar con la misma clave vuelve a ejecutar la solicitud.
- Las credenciales nunca se guardan: en `POST /v1/partner/workspaces`, la respuesta repetida trae `api_key`, `webhook_secret` y `mcp_url` en `null` (rota la clave si la perdiste).
- Guardamos solo hashes de la clave y de la solicitud, junto a la respuesta.

## Freno a duplicados

`POST /v1/posts` rechaza el **mismo texto en la misma cuenta dentro de 24 h** con `409 duplicate_post` y `details.existing_post_id`. El texto se compara ignorando espacios en los extremos y espacios repetidos (las mayúsculas cuentan). Los posts fallidos no cuentan, y los cancelados se borran. También aplica a los posts simulados, para que lo veas mientras pruebas.

Si la persona de verdad quiere publicarlo otra vez, envía `"allow_duplicate": true` en el body (en el MCP, `permitir_duplicado: true`).
