Idempotency

​

The contract

curl -X POST "https://prod.skillsdbnext.com/api/v1/careers" \
  -H "Authorization: Bearer sdb_live_YOUR_KEY_HERE" \
  -H "Idempotency-Key: 0e8a7d1c-4f4b-4e9c-a2ce-1b6f2f6f9d55" \
  -H "Content-Type: application/json" \
  -d '{"name":"Maintenance Technician"}'

• First execution stores the successful response for 24 hours.
• A retry (same key, same method, path and body) replays it verbatim, with the header Idempotency-Replayed: true, executing nothing.
• Same key, different content → 409 idempotency-key-reused.
• Two concurrent duplicates → exactly one executes; the other briefly waits, then replays or returns a 409 conflict asking you to retry shortly.
• Errors are never replayed — a failed request releases the key so the same key can retry.

​

Rules of thumb