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

> Используйте стабильные заголовки Idempotency-Key в запросах на запись, чтобы повторы оставались безопасными и устранялись дубликаты.

# Идемпотентность

Все эндпоинты мутаций `POST` и `PATCH` принимают необязательный заголовок `Idempotency-Key`.

## Когда отправлять

Используйте ключ идемпотентности, когда:

* Клиент может повторить запрос после сбоя транспорта.
* Обработчик очереди может отправить одну и ту же логическую операцию более одного раза.
* AI-агент может повторно выполнить мутацию после частичного прогресса или повторных попыток инструмента.

## Рекомендуемый паттерн

* Генерируйте один стабильный ключ на одну логическую мутацию.
* Повторно используйте тот же ключ для повторов этой мутации.
* Меняйте ключ, когда меняется предполагаемая мутация.

## Примеры

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

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

## Правильные границы

* Один ключ для создания проекта.
* Другой ключ для экспорта этого проекта.
* И ещё один отдельный ключ для обновления настроек проекта.

Это делает повторы безопасными, не приводя к случайному устранению дубликатов для несвязанной работы.