Hatchet

Hatchet Workflow Runs API

The Workflow Runs API from Hatchet — 9 operation(s) for workflow runs.

GitHub OpenAPI

Operations 9

GET /api/v1/stable/tenants/{tenant}/workflow-runs List Workflow Runs #
GET /api/v1/stable/tenants/{tenant}/workflow-runs/display-names List Workflow Runs #
GET /api/v1/stable/tenants/{tenant}/workflow-runs/external-ids List Workflow Run External Ids #
POST /api/v1/stable/tenants/{tenant}/workflow-runs/trigger Create Workflow Run #
POST /api/v1/stable/tenants/{tenant}/durable-tasks/branch Branch Durable Task #
GET /api/v1/stable/workflow-runs/{v1-workflow-run} List Tasks #
GET /api/v1/stable/workflow-runs/{v1-workflow-run}/status Get Workflow Run Status #
GET /api/v1/stable/workflow-runs/{v1-workflow-run}/task-events List Tasks #
GET /api/v1/stable/workflow-runs/{v1-workflow-run}/task-timings List Timings for a Workflow Run #

Documentation

📖
Documentation
https://docs.hatchet.run/
📖
GettingStarted
https://docs.hatchet.run/home/quickstart
📖
APIReference
https://docs.hatchet.run/
📖
Authentication
https://docs.hatchet.run/
📖
RateLimits
https://artifacts.apis.io/hatchet/rate-limits/hatchet-rate-limits.yml

Specifications

⚙
OpenAPI
https://artifacts.apis.io/hatchet/openapi/hatchet-workflow-runs-api-openapi.yml

Code Examples

💻
CodeExamples
https://github.com/hatchet-dev/hatchet-python-quickstart
💻
CodeExamples
https://github.com/hatchet-dev/hatchet-typescript-quickstart
💻
CodeExamples
https://github.com/hatchet-dev/hatchet-go-quickstart
💻
CodeExamples
https://github.com/hatchet-dev/hatchet-typescript-deep-research
💻
CodeExamples
https://github.com/hatchet-dev/hatchet-typescript-code-agent
💻
CodeExamples
https://github.com/hatchet-dev/hatchet-infra-examples

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/hatchet/json-schema/hatchet-v1-task-schema.json
📊
JSONSchema
https://artifacts.apis.io/hatchet/json-schema/hatchet-v1-workflow-run-schema.json
📊
JSONSchema
https://artifacts.apis.io/hatchet/json-schema/hatchet-v1-event-schema.json
📊
JSONSchema
https://artifacts.apis.io/hatchet/json-schema/hatchet-v1-filter-schema.json
📊
JSONSchema
https://artifacts.apis.io/hatchet/json-schema/hatchet-v1-webhook-schema.json
📊
JSONSchema
https://artifacts.apis.io/hatchet/json-schema/hatchet-v1-task-event-schema.json
📊
JSONSchema
https://artifacts.apis.io/hatchet/json-schema/hatchet-v1-log-line-schema.json
📊
JSONSchema
https://artifacts.apis.io/hatchet/json-schema/hatchet-tenant-schema.json
📊
JSONSchema
https://artifacts.apis.io/hatchet/json-schema/hatchet-worker-schema.json
📊
JSONSchema
https://artifacts.apis.io/hatchet/json-schema/hatchet-rate-limit-schema.json
📊
JSONSchema
https://artifacts.apis.io/hatchet/json-schema/hatchet-api-token-schema.json
📊
JSONSchema
https://artifacts.apis.io/hatchet/json-schema/hatchet-workflow-schema.json

Other Resources

🔗
Examples
https://artifacts.apis.io/hatchet/examples/v1-task-get-example.json
🔗
Examples
https://artifacts.apis.io/hatchet/examples/v1-workflow-run-trigger-example.json
🔗
Examples
https://artifacts.apis.io/hatchet/examples/v1-event-create-example.json
🔗
Examples
https://artifacts.apis.io/hatchet/examples/v1-filter-create-example.json
🔗
Examples
https://artifacts.apis.io/hatchet/examples/v1-task-cancel-example.json
🔗
Examples
https://artifacts.apis.io/hatchet/examples/v1-task-replay-example.json
🔗
Examples
https://artifacts.apis.io/hatchet/examples/v1-log-line-list-example.json
🔗
Examples
https://artifacts.apis.io/hatchet/examples/rate-limit-upsert-example.json
🔗
Examples
https://artifacts.apis.io/hatchet/examples/webhook-worker-create-example.json
🔗
Examples
https://artifacts.apis.io/hatchet/examples/worker-list-example.json
🔗
SDKs
https://pypi.org/project/hatchet-sdk/
🔗
SDKs
https://www.npmjs.com/package/@hatchet-dev/typescript-sdk
🔗
SDKs
https://github.com/hatchet-dev/hatchet/tree/main/sdks/go
🔗
SDKs
https://github.com/hatchet-dev/hatchet/tree/main/sdks/ruby
🔗
SelfHosting
https://docs.hatchet.run/self-hosting
🔗
SourceCode
https://github.com/hatchet-dev/hatchet

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/hatchet:hatchet-workflow-runs-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

hatchet-workflow-runs-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: 1.0.0
  title: Hatchet Workflow Runs API
  description: The Hatchet API
servers:
- url: ''
security:
- bearerAuth: []
- cookieAuth: []
tags:


# --- truncated at 32 KB (33 KB total) ---
# Full source: https://artifacts.apis.io/hatchet/openapi/hatchet-workflow-runs-api-openapi.yml