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

# Idempotency

> Retry create requests safely with Idempotency-Key.

Create endpoints require an `Idempotency-Key` header. This protects clients from duplicate resources when a network timeout or retry happens after the backend has already accepted the request.

```bash theme={null}
Idempotency-Key: 8f92cc68-b7db-4c3a-8f5b-4f68131a55b0
```

## Rules

* Use a unique key per create operation.
* Reuse a key only to retry the same request body on the same endpoint.
* If the same key is reused with a different payload, the API returns a conflict.
* If the original request is still processing, the API returns an in-progress conflict.

## Applies To

Create operations for categories, courses, sections, lessons, assessments, assignments, quizzes, and uploads require idempotency.

## Example

```bash theme={null}
curl "https://staging.api.soludesks.com/v1/external/learnhub/courses" \
  -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: 8f92cc68-b7db-4c3a-8f5b-4f68131a55b0" \
  -H "Content-Type: application/json" \
  -d '{"name":"Customer Support Foundations","description":"Onboarding course"}'
```