Skip to main content
POST
Start a response

Authorizations

Authorization
string
header
required

API key issued from the Blend AI dashboard. Prefix: bai_. Send as Authorization: Bearer bai_....

Body

application/json
workflowId
string
required

Published workflow ID or owner-scoped API slug.

Example:

"pub_abc123"

versionId
string

Pin to a specific published version. Defaults to the latest published version.

Example:

"ver_xyz789"

stream
boolean
default:false

When true, the response is an SSE stream. When false, returns 202 with a run_id for polling.

inputs
object

Workflow inputs keyed by the normalized label of each User Input node. Text inputs are strings; file/image/video inputs are URLs or uploaded file references. Internal Batch rows are not public API inputs unless exposed through User Input nodes.

Example:

Response

Server-Sent Events stream (when stream: true).

Newline-delimited SSE frames.