Workers
Status, doctor, smoke tests, n8n bundle import, and local AI CLI sessions.
Worker and readiness endpoints under /api/v1/workers. Unless noted, send Authorization: Bearer (any valid API key scoped to the workspace). Session twins under /api/workers/* use the app cookie and workspaceId query or body.
Wrong or missing bearer → 401 { error: "Valid bearer API key is required" }. Session calls without workspace access → the workspace-auth error for that action.
Endpoints
| Method | Path | Description |
|---|---|---|
| GET | /api/v1/workers/status | Public worker status |
| GET | /api/v1/workers/doctor | Compact platform doctor |
| POST | /api/v1/workers/smoke-test | Temporary safe deployment smoke |
| POST | /api/v1/workers/n8n/import-bundle | Import server bundle JSON or path |
| POST | /api/v1/workers/n8n/smoke-test | Imported n8n bundle smoke + audit |
| POST | /api/v1/workers/n8n/credentials/bootstrap-from-env | Create missing n8n-mapped credentials from env |
| POST | /api/v1/workers/n8n/subflows/import-originals | Import original n8n child JSON |
| POST | /api/v1/workers/luminai/smoke-test | LuminAI alias of n8n smoke |
| POST | /api/v1/workers/luminai/credentials/bootstrap-from-env | LuminAI credential bootstrap |
| POST | /api/v1/workers/luminai/subflows/import-originals | LuminAI subflow import |
| POST | /api/v1/workers/local-ai-cli/session | prepare / verify / disconnect |
| POST | /api/v1/workers/local-ai-cli/login | Start CLI login |
| POST | /api/v1/workers/local-ai-cli/callback | Finish browser login |
| POST | /api/v1/workers/local-ai-cli/token | Claude Code token capture |
| GET | /api/v1/workers/local-ai-cli/models | Discovered CLI models |
Status
GET /api/v1/workers/status?now= optional ISO timestamp (invalid → 400). Returns { status } from toPublicWorkerStatus: queue (direct | bullmq, queueName: "workflow-runs", workerConcurrency, optional counts, error), persistence, database, scheduler, health, localAiCli, managedWorkspaces, agentRuntime, sideEffectTransports (no envVar), deployment (labels, not env names), run counters, recentRuns, latestSmokeTest, checkedAt.
Doctor
GET /api/v1/workers/doctor?now=&bundlePath=. Returns { doctor } compact: status, workspaceId, checkedAt, source, appUrl, persistence/database, queue subset, scheduler subset, workerHealth, deployment missing lists, localAiCli, managedWorkspaces, agentRuntime, n8nBundle, blockers, warnings, nextActions. Connection strings and env var names are stripped.
Smoke test
POST /api/v1/workers/smoke-test
| Field | Type | Effect |
|---|---|---|
targetWorkflowId | string | Audit only; temp workflow still runs |
useQueue | boolean | Force queue or inline |
waitForWorkerMs | number | How long to wait for a queued temp run |
Envelope { smokeTest }. HTTP 200 passed, 202 attention, 500 failed.
n8n smoke: POST /api/v1/workers/n8n/smoke-test { bundlePath?, useQueue?, waitForWorkerMs? } → { importedWorkflowSmokeTest } with the same status codes. Includes persistence.durable.
n8n bundle
POST /api/v1/workers/n8n/import-bundle { importBundleJson?, bundlePath? } → 201 import result + doctor. 400 on parse/import failure.
POST /api/v1/workers/n8n/credentials/bootstrap-from-env { bundlePath? } → { bootstrap, doctor } (public bootstrap: created/skipped counts, no secret values). 400 on bootstrap error.
POST /api/v1/workers/n8n/subflows/import-originals { importJson? \| importBundleJson } → 201 { importResult, doctor }.
Local AI CLI
Session POST body { action?, kind? }. action default verify; allowed prepare, verify, disconnect. kind optional claudeCode | codexCli. Returns { session: { workspaceId, ...public readiness } }.
Login: { kind } required. Callback: { callbackUrl } required. Token: { kind: "claudeCode", token } only. Models: ?kind= (400 if invalid). Persistence failure after a successful verify → 500.
Session HTTP copies: /api/workers/status, /doctor, /smoke-test, /n8n/*, /luminai/*, /local-ai-cli/*.