Instant Task Acceptance

When you submit a task to AsyncQueue, the API returns immediately with a task ID. Your application continues without waiting for the callback to execute.

How it works

1. Your application sends a POST /v1/tasks request with a callback URL
2. AsyncQueue validates the request, queues the task, and returns a 201 Created response
3. A background worker picks up the task and executes the HTTP callback
4. You check the result later via GET /v1/tasks/:id or receive a notification via onCompleteUrl

Why this matters

• No blocking - Your API responds to users immediately, even when triggering long-running work
• Better reliability - If a callback fails, AsyncQueue retries automatically without your application being involved
• Higher throughput - Queue thousands of tasks per second without overwhelming your backend services
• Resilience - Tasks survive service restarts and temporary outages

Common use cases

• Sending transactional emails or push notifications
• Processing uploaded files (resize images, generate thumbnails, transcode video)
• Syncing data to third-party services (CRM updates, analytics events)
• Generating reports or PDF exports
• Running batch operations across large datasets