Skip to main content

​
What is DispatchQ?

DispatchQ is an HTTP job queue. You enqueue jobs via REST API, the DispatchQ CLI, or MCP tool calls. DispatchQ makes reliable HTTP requests to any URL you specify — webhooks, API endpoints, internal services, third-party APIs — with retries, HMAC signatures, and stored results. Start with the Quickstart, then see CLI Install, MCP Setup, and the API Reference.

One API call

POST /v1/jobs with a URL and payload. That’s it. No SDK required, no workers, no Redis.

Stored results

Every job’s response is stored and retrievable. No callback endpoints, no log diving.

Human approval

Pause jobs for human sign-off before execution. First-class support for consequential actions.

MCP-native

Built-in MCP server so AI agents can enqueue and manage jobs as tool calls.

​
Quick example

# Enqueue a job
curl -X POST https://api.dispatchq.dev/v1/jobs \
  -H "Authorization: Bearer dq_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://myapp.com/process",
    "payload": { "file": "data.csv" }
  }'

# Check the result later
curl https://api.dispatchq.dev/v1/jobs/job_V1StGXR8_Z5j \
  -H "Authorization: Bearer dq_live_..."

​
Job lifecycle

pending -> active -> completed     (success)
pending -> active -> pending       (retry on failure)
pending -> active -> failed        (retries exhausted)
pending -> cancelled               (user cancelled)
pending -> awaiting_approval -> pending -> ...  (approval flow)

​
Key features

  • Per-job pricing - A 5-step pipeline = 1 job. No per-message multiplication.
  • Exponential backoff - 20s, 40s, 80s… up to 1 hour between retries.
  • HMAC signatures - Every HTTP request is signed for authenticity (for webhook verification).
  • Cron schedules - Recurring jobs with standard cron expressions.
  • Deduplication - Prevent duplicate execution with dedupe keys.
  • Idempotency - Idempotency-Key header prevents double-submission.
  • Rate limiting - Built-in per-account rate limiting.
  • Request IDs - Every response includes X-Request-Id for tracing.