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.

API keysSDK client

Headers

NameInTypeDescription
x-blekline-workspace-tokenRequiredheaderstringWorkspace token blw_… from API keys.

Scopes

ScopeGroupSummaryExamples
runs:writeAct & runsStart governed act runsPOST /api/workspace/cell-runs, createCellRun()
runs:readAct & runsList and inspect runsGET /api/workspace/cell-runs, listCellRuns()
integrations:writePolicy & connectorsConfigure connectors and SIEM hooksConnector OAuth, integration setup APIs
events:writeIngress & auditIngest audit and telemetry eventsPOST /api/events, emitEvent()
events:readIngress & auditRead workspace event streamsCompliance exports, audit integrations
mask:writeIngress & auditMask prompts at ingressPOST /api/mask, IDE hooks, SDK mask()