Idempotency

Ensure safe retries with idempotency keys.

Include an `Idempotency-Key` header on JSON requests that create work or request signed access. Reusing the same key returns the original successful response instead of creating a duplicate operation.

Idempotent POST requestBash

curl -X POST https://api.omtx.ai/v2/data-access/shards \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Idempotency-Key: export-$(date +%s)" \
  -H "Content-Type: application/json" \
  -d '{"protein_uuid":"550e8400-e29b-41d4-a716-446655440000"}'

Notes

Use UUIDs or timestamps for unique keys.
Same key returns the cached response.
Required on current POST/PUT/DELETE routes that create or update work, including data access, diligence, and Hub launches.
POST /v2/artifacts/upload is the current exception; the SDK artifact helpers do not take idempotency_key= today.