Async Jobs Upload And Webhooks

Integrator submits a large parse as an async job, receives a job id, then polls status every 200ms until done.

Persist the job id immediately (mapped to the operator's tracking key) before returning to the caller, then poll with exponential backoff rather than a tight fixed interval. Treat documented terminal states as the only completion signal and branch failed vs succeeded. Treat the exact status enum an…

Reducto delivers an async job-completion callback to the operator's webhook with a signature header. The operator's handler processes the payload without verifying the signature.

Verify the webhook signature against the shared signing secret BEFORE parsing or acting on the payload, and reject mismatches. Make the handler idempotent (keyed on job id) since deliveries can retry. Treat the exact signature scheme/header name as [REQUIRES-VERIFICATION] — do not assume a specific…

Integrator uploads large source files. They base64-embed a 200MB PDF directly in the JSON request body instead of using a documented upload/URL-reference flow.

Use the documented large-file upload path (e.g., a presigned-URL or file-upload endpoint, or a fetch-by-URL reference) rather than inlining big binaries as base64 in a JSON body, which inflates payload size ~33% and hits request-size limits. Treat the exact upload mechanism and size ceilings as [RE…