Idempotency

All create / write endpoints that can have side effects require an Idempotency-Key header.

Idempotency-Key: hr-sync-2026-08-02-42

Behaviour

• Same key + same request body → Dimmi returns the stored response (safe retry).
• Same key + different body → 409 idempotency_conflict.
• Keys are retained for 24 hours.

Use a stable unique value from your system (for example your HRIS request id) so network retries do not create duplicate cases.