Idempotency - GoSentrix

curl -X POST https://api.gosentrix.io/api/v1/tenants \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Idempotency-Key: unique-key-12345" \
  -H "Content-Type: application/json" \
  -d '{"name": "My Company"}'

Idempotent requests ensure safe retries without side effects.

Idempotency Keys

Include an Idempotency-Key header in POST/PUT/PATCH requests:

curl -X POST https://api.gosentrix.io/api/v1/tenants \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Idempotency-Key: unique-key-12345" \
  -H "Content-Type: application/json" \
  -d '{"name": "My Company"}'

How It Works

First request with key: Processed normally
Subsequent requests with same key: Returns original response
Key validity: 24 hours

Best Practices

Generate unique keys (UUIDs recommended)
Include keys for all mutating operations
Store keys for retry scenarios
Use keys for webhook retries

Supported Endpoints

All POST, PUT, and PATCH endpoints support idempotency keys.