Hatchet is an open-source distributed task queue and workflow orchestration engine for background jobs, AI agents, and durable workflows. It is Postgres-backed, MIT-licensed, and ships with first-class SDKs for Python, TypeScript, Go, and Ruby plus a managed offering (Hatchet Cloud) and a self-hostable engine (Docker Compose, Hatchet Lite, Helm chart). The platform separates the orchestration engine from worker execution so workers can run on the operator's own infrastructure (Kubernetes, ECS, Render, Railway, Porter, or any container platform).
URL: Visit APIs.json URL
Run: Capabilities Using Naftiko
- Task Queue, Workflow Engine, Durable Execution, Background Tasks, AI Agents, Orchestration, PostgreSQL, Open Source
- Created: 2026-03-27
- Modified: 2026-05-25
The Hatchet REST API is the control plane for the Hatchet engine. It exposes operations for tasks, workflow runs, durable tasks, events, filters (CEL-based event routing), webhooks/webhook workers, tenants, users, workers, scheduled and cron workflows, alerting, rate limits, API tokens, observability (logs, traces, metrics), feature flags, and engine metadata. The contract is OpenAPI 3.1 and ships in-tree at hatchet-dev/hatchet under api-contracts/openapi. Stable endpoints are namespaced under /api/v1/stable; legacy endpoints remain under /api/v1. Authentication is bearer token or session cookie.
Human URL: https://docs.hatchet.run/
- Task Queue, Workflow Engine, Durable Execution, Background Tasks, AI Agents, Orchestration
- Documentation
- Getting Started
- Quickstart
- API Reference
- OpenAPI
- OpenAPI (canonical, $ref-composed)
- Python SDK (PyPI)
- TypeScript SDK (npm)
- Go SDK
- Ruby SDK
- Python Quickstart
- TypeScript Quickstart
- Go Quickstart
- Deep Research Agent Pattern (TS)
- Coding Agent Pattern (TS)
- Worker Infrastructure Walkthroughs
- Authentication (Bearer + Cookie)
- Rate Limits
- Self Hosting
- Source Code
- Website
- Documentation
- LLMs.txt
- Pricing
- Plans (machine-readable)
- Blog
- GitHub Organization
- GitHub Repository (hatchet-dev/hatchet)
- CLI installer
- Homebrew Tap
- Helm Chart
- Terraform Provider
- Compliance (SOC 2 / HIPAA)
| Name | Description |
|---|---|
| Durable Execution | Task and workflow state is persisted to Postgres so executions survive worker restarts, network partitions, and engine upgrades. |
| Low-Latency Scheduling | Sub-20ms task start times with intelligent assignment rules. |
| Code-First SDKs | Native language SDKs for Python, TypeScript, Go, and Ruby; tasks are versionable, testable functions. |
| Engine / Worker Separation | The orchestration engine and workers are decoupled; workers run on the customer's own infrastructure. |
| Postgres-Backed | Hatchet's only hard dependency is PostgreSQL; RabbitMQ is optional for higher-throughput deployments. |
| First-Class Rate Limits | Engine-level rate-limit primitive throttles task execution by named key, scope, and window — independent of HTTP rate limits. |
| CEL Event Filters | Common Expression Language filters bind incoming events to workflows with payload predicates. |
| Scheduled and Cron Workflows | One-shot scheduled runs and recurring cron-triggered workflows are first-class engine resources. |
| Webhook Workers | External HTTPS endpoints can be registered as workers; the engine delivers task runs as signed webhook requests. |
| OpenTelemetry Tracing | Workflows and tasks emit OTel traces; the engine exposes a trace lookup endpoint. |
| Replays and Restores | Failed or cancelled tasks can be replayed with the same input or restored to the run queue. |
| Multi-Tenant | Tenants isolate workflows, tasks, workers, and tokens; quotas and throughput are scoped per tenant. |
| Dashboard | Built-in web dashboard for inspecting runs, replaying tasks, and managing tenants. |
| Slack and SNS Alerting | Alerts can be dispatched to Slack channels or AWS SNS topics for ops escalation. |
| MIT-Licensed | Engine, API, SDKs, dashboard, and Helm chart are all MIT-licensed. |
| Name | Description |
|---|---|
| AI Agent Orchestration | Manage tool calls, conversation state, timeouts, and checkpointing for production AI agents. |
| Background Jobs | Classic distributed task-queue use case — replace Celery, Sidekiq, BullMQ, or RQ with durable equivalents. |
| Durable Workflows | Multi-step pipelines with retries, conditional branching, and exactly-once semantics. |
| Ingestion and Indexing | Keep vector databases, knowledge graphs, and search indexes up-to-date as upstream sources change. |
| Massive Parallelization | Fan out to thousands of workers for batch processing and embarrassingly parallel workloads. |
| Mission-Critical Workloads | Workloads where retries, checkpointing, and replay are non-negotiable (payments, billing, compliance). |
| Event-Driven Architectures | Use events + CEL filters to route external signals into the right workflows without bespoke routing code. |
| Name | Description |
|---|---|
| PostgreSQL | The durability substrate; Hatchet ships with managed migrations and is happy on RDS, Cloud SQL, Neon, Supabase, or self-hosted Postgres. |
| RabbitMQ | Optional message bus for inter-service communication and high-throughput real-time updates. |
| Kubernetes | Official Helm chart at hatchet-dev/hatchet-charts for production self-hosting. |
| Docker | Hatchet Lite single-image deployment plus a production Docker Compose stack. |
| AWS (ECS, SNS) | ECS-friendly worker deployment patterns and first-class SNS alerting. |
| Slack | Native Slack alerting integration for run failures and SLA breaches. |
| GitHub | GitHub OAuth login for the dashboard plus repo-linked workflow source. |
| OpenTelemetry | Engine and SDKs emit OTel traces; the API exposes trace lookup. |
| Terraform | Official Terraform provider for managing Hatchet Cloud resources as code. |
| Homebrew | brew install via the hatchet-dev/homebrew-hatchet tap. |
| FastAPI | Documented quickstart for combining Hatchet Python SDK with FastAPI services. |
| Next.js | Multiple Next.js starter templates wire Hatchet into App Router and Pages Router projects. |
| Anthropic | Hatchet's durable-execution model is a natural substrate for orchestrating Anthropic Claude tool calls and multi-step agents; the hatchet-typescript-deep-research and hatchet-typescript-code-agent reference patterns illustrate the integration shape. |
| Name | Description |
|---|---|
| Hatchet Cloud | Fully managed orchestration engine on Hatchet's infrastructure with tier-included task-run allowances and SOC 2 / HIPAA controls. |
| Self-Hosted (Open Source) | MIT-licensed engine, API, dashboard, and Helm chart for running Hatchet on the operator's own infrastructure. |
| Hatchet Lite | Single-image bundled deployment of engine, API, and dashboard for development, testing, and low-throughput production. |
| Bring-Your-Own-Cloud (Enterprise) | Enterprise tier deploys the Hatchet engine inside the customer's own VPC while remaining managed by Hatchet. |
Machine-readable API specifications organized by format.
- Hatchet API (bundled OpenAPI 3.1) — 141 operations across 23 resource tags
- V1 Task
- V1 Workflow Run
- V1 Event
- V1 Filter
- V1 Webhook
- V1 Task Event
- V1 Log Line
- Tenant
- Worker
- Rate Limit
- API Token
- Workflow
- V1 Task
- V1 Workflow Run
- V1 Event
- V1 Filter
- V1 Webhook
- V1 Task Event
- V1 Log Line
- Tenant
- Worker
- Rate Limit
- API Token
- Workflow
- Hatchet Context — Linked-data context aligning Hatchet entities with schema.org
- Get Task
- Trigger Workflow Run
- Publish Event
- Create Filter
- Cancel Tasks
- Replay Tasks
- List Task Logs
- Upsert Rate Limit
- Register Webhook Worker
- List Workers
- Plans and Pricing — Developer, Team, Scale, Enterprise, Self-Hosted
- Rate Limits — Per-tier throughput and engine-level rate-limit primitive
- FinOps Mapping — FOCUS-aligned, task-run as the primary billable unit
Naftiko capabilities organized as shared per-API definitions composed into customer-facing workflows.
- Hatchet Orchestration — 9 operations for triggering, observing, and controlling task and workflow runs
- Events and Filters — 8 operations for publishing events and binding them to workflows via CEL filters
- Tenant Governance — 11 operations for managing tenants, tokens, workers, and engine rate limits
- Hatchet Vocabulary — Controlled vocabulary covering 33 terms across 7 domains (Orchestration, Workflow, Execution, Event Ingestion, Observability, Governance, Deployment)
- Hatchet Ruleset — 13 Spectral rules enforcing Hatchet's OpenAPI conventions (path namespacing, operation ID format, tag taxonomy, bearer auth, error schema standardization)
FN: Kin Lane
Email: kin@apievangelist.com