Skip to main content

Idempotency

All write endpoints honor Idempotency-Key headers. Send the same key twice, get the same response — no duplicate resources, no double-delivered webhooks.

Usage

Include an Idempotency-Key header with a unique string (UUID recommended) on any POST, PUT, PATCH, or DELETE request. The key is valid for 24 hours after first use.

curl -X POST https://api.talonic.com/v1/extract \
  -H "Authorization: Bearer $TALONIC_API_KEY" \
  -H "Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000" \
  -F "file=@invoice.pdf"

Behavior

If a request with the same idempotency key has already been processed, the API returns the original response without re-executing the operation. This makes it safe to retry failed network requests without risk of duplicate side effects.

Related

Extract
Idempotent document extraction.
Create Source
Idempotent source creation.
Errors
Error handling and retries.