Hatchet API
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.
Documentation
Documentation
https://docs.hatchet.run/
GettingStarted
https://docs.hatchet.run/home/quickstart
Quickstart
https://docs.hatchet.run/home/quickstart
APIReference
https://docs.hatchet.run/
Authentication
Bearer Token + Session Cookie
RateLimits
https://raw.githubusercontent.com/api-evangelist/hatchet/refs/heads/main/rate-limits/hatchet-rate-limits.yml
Specifications
OpenAPI
https://raw.githubusercontent.com/api-evangelist/hatchet/refs/heads/main/openapi/hatchet-openapi.yml
OpenAPI
Source OpenAPI (canonical, $ref-composed)
SDKs
SDK
Python SDK (hatchet-sdk on PyPI)
SDK
TypeScript SDK (@hatchet-dev/typescript-sdk on npm)
SDK
Go SDK (in-tree at sdks/go)
SDK
Ruby SDK (in-tree at sdks/ruby)
Code Examples
CodeExamples
Python Quickstart
CodeExamples
TypeScript Quickstart
CodeExamples
Go Quickstart
CodeExamples
Deep Research Agent Pattern (TypeScript)
CodeExamples
Coding Agent Pattern (TypeScript)
CodeExamples
Worker Infrastructure Walkthroughs
Examples
Example
Get Task
Example
Trigger Workflow Run
Example
Publish Event
Example
Create Filter
Example
Cancel Tasks
Example
Replay Tasks
Example
List Task Logs
Example
Upsert Rate Limit
Example
Register Webhook Worker
Example
List Workers
Schemas & Data
JSONSchema
V1 Task
JSONSchema
V1 Workflow Run
JSONSchema
V1 Event
JSONSchema
V1 Filter
JSONSchema
V1 Webhook
JSONSchema
V1 Task Event
JSONSchema
V1 Log Line
JSONSchema
Tenant
JSONSchema
Worker
JSONSchema
Rate Limit
JSONSchema
API Token
JSONSchema
Workflow