What's available

The Atomic Work REST API lets you integrate workflows into any system that can make an HTTP request. Starting today, you can:

Trigger workflow runs — POST /api/v1/runs with a procedureId and input data

Check run status — GET /api/v1/runs/{id} returns current status, step index, and logs

List active runs — GET /api/v1/runs with optional filters by status and workflow

Resume paused runs — POST /api/v1/runs/{id}/resume to advance a WAITING_FOR_USER run programmatically

Webhook events — configure a webhook URL to receive events when runs change state

Authentication

Generate an API key from Settings → API Keys. All keys are prefixed with aw_live_ and scoped to your organisation. Keys are shown once at creation — store them securely.

Include your key in the Authorization header:

Authorization: Bearer aw_live_your_key_here

Triggering a run

POST /api/v1/runs
{
  "procedureId": "proc_abc123",
  "input": {
    "employee_name": "Jane Smith",
    "start_date": "2026-05-01",
    "team": "Engineering"
  }
}

The response includes a runId you can use to poll for status or receive webhook events.

Webhook events

Configure a webhook endpoint in Settings → Integrations. We'll send a POST request to your endpoint for each of these events:

run.started — a new run has been created

run.step_completed — a step has been completed

run.waiting_for_user — the run is paused waiting for a human action

run.completed — the run has finished successfully

run.failed — the run has encountered an error

Each event payload includes the runId, orgId, current status, and step data.

Rate limits

The API is rate-limited at 100 requests per minute per organisation on the free plan, and 1,000 requests per minute on paid plans. Rate limit headers are included in every response.

What to build

Some ideas from our early API users:

ATS integration — trigger an onboarding workflow automatically when a candidate is marked hired in your ATS

Slack bot — let employees trigger common workflows from a Slack command

Jira integration — create a run for every new Jira ticket matching a specific label

Monitoring alerts — trigger an incident response workflow when an alert fires

Full API documentation is at /developers. If you build something interesting, let us know — we'd love to feature it.

The Atomic Work REST API is live