Idempotency and Duplicate Protection
Prevent double processing and duplicate charges when retrying Manifest AI document submissions.
Idempotency protects network retries; file fingerprints protect against accidental resubmission. They solve different problems and should both remain enabled.
Idempotency-Key
One logical upstream document should keep one stable key.
- Required for POST /api/v1/documents.
- Use 8–128 safe characters.
- Persist it with your shipment, invoice, or ingestion record.
- A replay with the same payload returns the original document.
- A different payload under the same key returns HTTP 409.
Duplicate file detection
A matching file fingerprint warns when the same PDF was already processed.
Use allow_duplicate=true only after your application confirms that identical bytes represent intentional new work. Do not set it globally.