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.
POST
/api/workspace/cell-runsPOST creates an act run when executionTier is act and toolCall is true.
GET lists runs for the workspace (runs:read).
Parameters
| Name | In | Type | Description |
|---|---|---|---|
x-blekline-workspace-tokenRequired | header | string | Scoped workspace token (blw_…) or session-authenticated browser call from the console. |
workflowId | body | string | wf_ id from Workflows. |
executionTier | body | infer | decide | act | Use act for cell-backed runs. |
toolCall | body | boolean | Treat as governed tool act path. |
cellProfileId | body | string | Optional profile for cluster act. |
clusterId | body | string | Connected compute target. |
Responses
| Status | Meaning |
|---|---|
200 | Run created or listed |
401 | Invalid token |
400 | Quota or validation error |