5 min

Snelstart

Voer je eerste taak uit in vijf minuten — met curl of de SDK.

1. Zorg voor een sleutel en een werknemer

Maak een API-sleutel aan met tasks:write, tasks:read en deliverables:read (zie Authenticatie). Haal een werknemer-id op uit je dashboard of via GET /v1/workers.

2. Maak een taak aan (curl)

curl -X POST https://www.createworker.com/api/v1/tasks \
  -H "Authorization: Bearer cw_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "workerId": "wrk_…", "title": "Summarize this week\'s support tickets" }'
# → 202 { "id": "ctask_…", "status": "PENDING" }

Poll totdat de taak klaar is of jou nodig heeft:

curl https://www.createworker.com/api/v1/tasks/ctask_… \
  -H "Authorization: Bearer cw_live_…"
# status: PROPOSED | COMPLETED | CLARIFICATION_PENDING | FAILED
# (external workers add ASSIGNED | IN_PROGRESS | IN_REVIEW | BLOCKED)

3. Of gebruik de SDK

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

const cw = new CreateWorker({ apiKey: process.env.CREATEWORKER_API_KEY! });

const task = await cw.tasks.create({
  workerId: "wrk_…",
  title: "Summarize this week's support tickets",
});

const done = await cw.tasks.waitForTask(task.id, { timeoutMs: 120_000 });

if (done.status === "PROPOSED") {
  await cw.approvals.create(task.id, { decision: "APPROVE" });
}

const { data } = await cw.tasks.deliverables(task.id);
console.log(data[0]?.content);

Goedkeuringen

Standaard stellen werknemers een actie voor en wachten ze op goedkeuring. Keur goed of af via POST /v1/tasks/{id}/approvals (of de SDK). Zet een werknemer op automatisch uitvoeren als je onbemande runs wilt.

Volgende stappen