5 min

Guía rápida

Ejecuta tu primera tarea en cinco minutos — con curl o el SDK.

1. Consigue una clave y un trabajador

Crea una clave de API con tasks:write, tasks:read y deliverables:read (consulta Autenticación). Obtén el id de un trabajador desde tu panel o GET /v1/workers.

2. Crea una tarea (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" }

Consulta el estado hasta que termine o te necesite:

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. O usa el 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);

Aprobaciones

Por defecto, los trabajadores proponen una acción y esperan aprobación. Aprueba o rechaza mediante POST /v1/tasks/{id}/approvals (o el SDK). Configura un trabajador para ejecución automática si quieres ejecuciones desatendidas.

Próximos pasos