> ## 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

> Utilisez des en-têtes Idempotency-Key stables sur les requêtes d’écriture afin que les tentatives restent sûres et dédupliquées.

# Idempotence

Tous les endpoints de mutation `POST` et `PATCH` acceptent un en-tête optionnel `Idempotency-Key`.

## Quand l’envoyer

Utilisez une clé d’idempotence lorsque :

* Un client peut réessayer après une défaillance de transport.
* Un worker de file d’attente peut envoyer la même opération logique plus d’une fois.
* Un agent d’IA peut relancer une mutation après une progression partielle ou des nouvelles tentatives d’outil.

## Modèle recommandé

* Générez une clé stable par mutation logique.
* Réutilisez la même clé pour les nouvelles tentatives de cette mutation.
* Changez la clé lorsque la mutation prévue change.

## Exemples

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

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

## Bonnes limites

* Une clé pour créer un projet.
* Une clé différente pour exporter ce projet.
* Une autre clé différente pour mettre à jour les paramètres du projet.

Cela permet de garder les tentatives sûres sans dédupliquer accidentellement du travail sans rapport.