Cloud API Reference

The cloud platform exposes a REST API and real-time event streams so you can create, run, and monitor workflows programmatically — for CI pipelines, schedulers, or integration into your own tooling.

The canonical, complete reference lives in the dedicated API section:

Authentication — Clerk session JWTs, bearer tokens, team context.
REST API Reference — workflows, runs, files, credits, AI, sharing.
WebSocket Events — live run progress (SSE) and editor sync.

Quick example

# Start a run of an existing workflow on an 8 vCPU / 64 GB worker
curl -X POST https://bionodulo.com/api/runs \
  -H "Authorization: Bearer $BIONODULO_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "workflowId": "9f1c…", "compute": { "vcpu": 8, "ramGb": 64 } }'

{
  "success": true,
  "data": { "runId": "7a2e…", "status": "queued" }
}

Poll GET /api/runs/{runId} or stream GET /api/runs/{runId}/stream (SSE) for live progress, then fetch artifacts from GET /api/runs/{runId}/outputs.

Cloud API Reference

Quick example

See also