Async Processing

Async processing is processing that runs in the background without blocking the caller. A request returns immediately (e.g., with a job ID); results become available when processing completes. Use polling or webhooks to be notified.

When DocLD Uses Async

• Document upload — Parsing, chunking, and embedding run asynchronously
• Extraction — Large or batch extraction jobs run in the background
• Batch processing — Batch processing typically uses async processing per document

Benefits

• Non-blocking — Caller doesn't wait for long operations
• Throughput — Many jobs can run concurrently
• Resilience — Timeouts are less likely; retries can be coordinated with idempotency

Related Concepts

Async processing relies on jobs and webhooks. Batch processing uses async for per-document handling. Idempotency makes retries safe.