curl -sS -X POST "https://app.blekline.com/api/workspace/cell-runs" \
  -H "Content-Type: application/json" \
  -H "x-blekline-workspace-token: $BLEKLINE_WORKSPACE_TOKEN" \
  -d '{
    "workflowId": "wf_your_workflow_id",
    "displayName": "First workflow run",
    "executionTier": "act",
    "toolCall": true
  }'

Cell Runs

Create and list governed act runs. POST returns a run row with compileHash at birth.

Open runsAPI keys
POST/api/workspace/cell-runs

POST creates an act run when executionTier is act and toolCall is true.

GET lists runs for the workspace (runs:read).

Parameters

NameInTypeDescription
x-blekline-workspace-tokenRequiredheaderstringScoped workspace token (blw_…) or session-authenticated browser call from the console.
workflowIdbodystringwf_ id from Workflows.
executionTierbodyinfer | decide | actUse act for cell-backed runs.
toolCallbodybooleanTreat as governed tool act path.
cellProfileIdbodystringOptional profile for cluster act.
clusterIdbodystringConnected compute target.

Responses

StatusMeaning
200Run created or listed
401Invalid token
400Quota or validation error