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

# Idempotency

> Usa encabezados Idempotency-Key estables en solicitudes de escritura para que los reintentos sigan siendo seguros y se dedupliquen.

# Idempotencia

Todos los endpoints de mutación `POST` y `PATCH` aceptan un encabezado opcional `Idempotency-Key`.

## Cuándo enviarlo

Usa una clave de idempotencia cuando:

* Un cliente puede reintentar después de un fallo de transporte.
* Un worker de cola puede despachar la misma operación lógica más de una vez.
* Un agente de IA puede volver a ejecutar una mutación después de un progreso parcial o reintentos de herramienta.

## Patrón recomendado

* Genera una clave estable por mutación lógica.
* Reutiliza la misma clave para los reintentos de esa mutación.
* Cambia la clave cuando cambie la mutación prevista.

## Ejemplos

```http theme={null}
Idempotency-Key: create-project-song-1
```

```http theme={null}
Idempotency-Key: export-song-1
```

## Buenos límites

* Una clave para crear un proyecto.
* Una clave diferente para exportar ese proyecto.
* Y otra clave diferente para actualizar la configuración del proyecto.

Esto mantiene los reintentos seguros sin deduplicar accidentalmente trabajo no relacionado.