Full Observability

AsyncQueue gives you full visibility into every task that flows through your queues. Track status in real time, inspect execution history, and debug failures without guesswork.

Task status tracking

Every task moves through a clear lifecycle:

Status	Description
pending	Waiting in the queue (or delayed)
active	Currently being executed
completed	Webhook returned a 2xx response
failed	All retry attempts exhausted

Check a task’s current state at any time:

curl https://api.asyncqueue.io/v1/tasks/task_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

Execution history

Each task records every attempt, including response codes, timestamps, and error details:

{
  "id": "task_abc123",
  "status": "completed",
  "attempts": [
    {
      "number": 1,
      "status": "failed",
      "response_code": 503,
      "executed_at": "2025-01-15T10:30:05Z",
      "error": "Service Unavailable"
    },
    {
      "number": 2,
      "status": "success",
      "response_code": 200,
      "executed_at": "2025-01-15T10:30:12Z"
    }
  ]
}

This makes it easy to understand exactly what happened with each task, including how many retries were needed and why earlier attempts failed.

Queue statistics

Get an overview of each queue’s health:

curl https://api.asyncqueue.io/v1/queues/notifications \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "name": "notifications",
  "stats": {
    "pending": 42,
    "active": 3,
    "completed": 15890,
    "failed": 12
  }
}

Filtering and listing

Find tasks by status, queue, or time range:

# List all failed tasks in a specific queue
curl "https://api.asyncqueue.io/v1/tasks?queue=emails&status=failed" \
  -H "Authorization: Bearer YOUR_API_KEY"

What you can answer

• How many tasks are pending in a queue right now?
• Did a specific task succeed or fail?
• How many retries did a task need before completing?
• What error did the webhook endpoint return?
• What is the overall health of my queues?