Anton.Docs
Dashboard (opens in a new tab)
How it works

Idempotency and retries

A retried create returns the original evaluation. It is not run again and no duplicate is stored.

POST /v1/intelligence/evaluations requires an Idempotency-Key header. Without one it returns 400 missing_idempotency_key.

HTTP
Idempotency-Key: intel-payee-crm-84012-v1

After a network timeout, retry the same request with the same key. If the first attempt finished, Anton returns the original response. If it is still being processed, you get 409 idempotency_in_flight: wait and retry with the same key.

The body also accepts idempotency_key as a fallback for testing. If both are sent, the header wins.

The usual rules apply: keys are kept for 24 hours, reusing one with a different body is 422 idempotency_key_reused, and a replay carries Idempotent-Replayed: true. See Idempotency. POST /v1/intelligence/evaluations/validate stores nothing and needs no key.

Something wrong or missing here? Open an issue (opens GitHub in a new tab) ↗