curl -sS "https://app.blekline.com/api/workspace/cell-runs" \ -H "x-blekline-workspace-token: $BLEKLINE_WORKSPACE_TOKEN"
Authentication
Send a scoped workspace token on every workspace route. Browser sessions use cookies; automation uses API keys.
Headers
| Name | In | Type | Description |
|---|---|---|---|
x-blekline-workspace-tokenRequired | header | string | Workspace token blw_… from API keys. |
Scopes
| Scope | Group | Summary | Examples |
|---|---|---|---|
runs:write | Act & runs | Start governed act runs | POST /api/workspace/cell-runs, createCellRun() |
runs:read | Act & runs | List and inspect runs | GET /api/workspace/cell-runs, listCellRuns() |
integrations:write | Policy & connectors | Configure connectors and SIEM hooks | Connector OAuth, integration setup APIs |
events:write | Ingress & audit | Ingest audit and telemetry events | POST /api/events, emitEvent() |
events:read | Ingress & audit | Read workspace event streams | Compliance exports, audit integrations |
mask:write | Ingress & audit | Mask prompts at ingress | POST /api/mask, IDE hooks, SDK mask() |