Skip to main content
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

  1. First request with key: Processed normally
  2. Subsequent requests with same key: Returns original response
  3. 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.