Skip to main content
POST
/
workflows
/
{workflowId}
/
runs
Run a workflow
curl --request POST \
  --url https://api.usebits.com/api/public/v1/workflows/{workflowId}/runs \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "task": "Also download the latest report",
  "model": "sonnet"
}
'
{
  "taskRunId": "clx123abc",
  "liveViewUrl": "https://browser-live-view.onkernel.com/abc123"
}

Authorizations

​
x-api-key
string
header
required

API key for authentication. Keys start with 'bb_' prefix.

Path Parameters

​
workflowId
string
required
Example:

"clx123abc"

Body

application/json
​
task
string

Additional instructions to append to the workflow definition

Example:

"Also download the latest report"

​
model
string

AI model to use (overrides workflow default)

Example:

"sonnet"

Response

Workflow run started successfully

​
taskRunId
string
required
Example:

"clx123abc"

​
liveViewUrl
string | null
required

URL to view the browser session in real-time

Example:

"https://browser-live-view.onkernel.com/abc123"