Sub-second Task Acceptance

AsyncQueue is designed to accept tasks as fast as possible. When you submit a task via the REST API, it is acknowledged and queued in under a second, so your calling function can return immediately without waiting for the work to complete.

How it works

1. Your application sends a POST request to create a task
2. AsyncQueue validates the payload and queues it instantly
3. Your application receives a response with the task ID and pending status
4. The task is executed asynchronously via your webhook endpoint

curl -X POST https://api.asyncqueue.io/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "queue": "default",
    "webhook_url": "https://your-app.com/webhooks/process",
    "payload": {"action": "send_report"}
  }'

The response comes back immediately:

{
  "id": "task_abc123",
  "queue": "default",
  "status": "pending",
  "created_at": "2025-01-15T10:30:00Z"
}

Why this matters

• No blocking - Your API endpoints stay fast because they offload heavy work to the queue
• Better user experience - Users get instant feedback while tasks process in the background
• Higher throughput - Your application can accept more requests without waiting on downstream services
• Resilience - If a downstream service is slow or down, your application still responds quickly

Common use cases

• Sending emails or notifications after a user action
• Processing file uploads (resizing images, generating thumbnails)
• Syncing data to third-party services
• Generating reports or exports
• Running batch operations across many records