Idempotency

Safely retry mutating requests with an Idempotency-Key.

Every mutating request accepts an optional Idempotency-Key header. Send a unique value (a UUID is ideal) and SoftSolz guarantees the operation runs at most once, even if the request is retried.

curl -X POST https://app.softsolz.uk/api/v1/services/forms/forms/SLUG/submissions \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Idempotency-Key: 7d3f0c2a-..." \
  -H "Content-Type: application/json" \
  -d '{"data":{"email":"a@example.com"}}'

• Replaying the same key with the same body returns the original result.
• Replaying the same key with a different body returns 409 with code: idempotency_key_conflict.
• Keys are retained for 24 hours.