REST API

API & SDK

Programmatically create and run AI workers, read results, approve actions, receive webhooks, and connect your own apps — over a versioned REST API and an official TypeScript SDK.

What you get

  • Public REST API at https://www.createworker.com/api/v1 — full platform: workers, tasks, approvals, deliverables, chat, knowledge, integrations, and webhooks.
  • External workers — hand a worker's tasks and chat to your own AI agent (e.g. Claude Code) and approve the results in CreateWorker.
  • TypeScript SDK — @createworker/sdk on npm, dependency-free, Node 18+.
  • Embeddable chat widget — drop an agent onto your website with one script tag.
  • MCP server — drive CreateWorker from Claude Code, Claude Desktop, and Cursor (@createworker/mcp).
  • Connect your own app — let a worker operate your site/API, and let your app trigger workers via signed webhooks.

Async by design

Task execution is asynchronous: you create a task (HTTP 202), then poll it or subscribe to webhooks. Worker writes always honor the worker's autonomy level, so they stay approval-gated unless the worker is set to auto-execute.

Start here

Authentication

Issue API keys, send Bearer tokens, understand scopes.

Quickstart

Run your first task with curl or the SDK in 5 minutes.

Webhooks

Subscribe to events and verify signatures.

Connect your app

Let a worker manage your website or helpdesk.

TypeScript SDK

Install @createworker/sdk and call the API type-safely.

MCP Server

Use CreateWorker in Claude Code, Claude Desktop, and Cursor.

External Workers

Run a worker's tasks with your own AI agent (e.g. Claude Code).

API reference

The full interactive OpenAPI reference.

Base URL & versioning

All endpoints live under a single versioned base path:

https://www.createworker.com/api/v1

The machine-readable spec is at /api/v1/openapi.json, and the interactive reference at /api/v1/docs.