TypeScript SDK

npm install @createworker/sdk

Requires Node 18+. Source: github.com/CreateWorkerAI/createworker-node.

import { CreateWorker } from "@createworker/sdk";

const cw = new CreateWorker({
  apiKey: process.env.CREATEWORKER_API_KEY!,     // cw_live_… / cw_test_…
  // baseUrl: "https://www.createworker.com",    // default
  // timeoutMs: 30_000, maxRetries: 2,
});

• cw.account — get(), usage()
• cw.workers — list / get / create / update / delete (create/update accept externalExecutor)
• cw.tasks — list / get / create / cancel / deliverables / waitForTask, plus external-runner claim / progress / submitDeliverable
• cw.chat — pending / messages / reply (answer an external worker's chat)
• cw.approvals — create(); cw.clarifications.answer()
• cw.deliverables — get()
• cw.knowledge — list / get / create / delete
• cw.integrations — connections / createApiConnection / createWebhookConnection / bind / unbind / deleteConnection
• cw.webhooks — register / list / get / update / delete

The tasks.claim/progress/submitDeliverable and chat methods are for building an external worker runner.

// Poll a task to a terminal/actionable status
const done = await cw.tasks.waitForTask(taskId, { timeoutMs: 120_000 });

// Verify an inbound webhook delivery (throws if invalid)
import { constructEvent, signInboundRequest } from "@createworker/sdk";
const event = constructEvent(rawBody, headers, secret);

// Sign an event your app sends to a CreateWorker webhook connection
const { body, headers } = signInboundRequest(payload, signingSecret);

The integrations namespace is how you wire your own product to a worker — see the Connect your app tutorial.