# Écritures et idempotence

> Idempotency-Key sur chaque POST, révision attendue, pause de l'IA sur un fan.

URL : https://docs.fanconvert.ai/fr/api/rest/ecritures

## Idempotency-Key [#idempotency-key]

Chaque `POST` exige un en-tête **`Idempotency-Key`** : 8 à 128 caractères `A-Z a-z 0-9 _ . : -`, un UUID par exemple.

- Rejouer la même clé avec la même requête rend **la même réponse sans seconde écriture** (en-tête `Idempotent-Replayed: true`), pendant 24 h.
- La même clé pour une autre requête répond `422`.
- Les `PUT` et `DELETE` sont idempotents par nature.

## La note de l'équipe [#la-note-de-léquipe]

Écrire la note exige la révision lue (`expectedRevision`) : une écriture concurrente répond `409`. Relisez la fiche du fan, puis réécrivez.

## Mettre l'IA en pause sur un fan (MYM) [#mettre-lia-en-pause-sur-un-fan-mym]

C'est le même geste que « Arrêter le chatting » dans le dashboard : le filtre de fans de la créatrice. Deux cas répondent `409` et se font depuis le dashboard, parce qu'ils dépassent ce fan :

- une créatrice qui répond à tous (le geste changerait son mode) ;
- le dernier fan d'une liste blanche (le retirer couperait toute la créatrice).

```bash
curl -X POST https://app.fanconvert.ai/public/v1/creators/emma-demo/conversations/123/ai/pause \
  -H "Authorization: Bearer $FANCONVERT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
```

`…/ai/resume` rend le fan à l'IA (« Relancer le chatting »).