Skip to main content
POST
Execute workflow

Authorizations

Authorization
string
header
required

Personal Access Token or OAuth2 JWT. Create a PAT at app.layer.ai → Settings → Personal Access Tokens.

Path Parameters

workspace_id
string<uuid>
required
workflow_id
string<uuid>
required

Body

application/json
inputs
Inputs · object
required

Input values matching the workflow's input schema.

session_id
string<uuid> | null

Existing session ID. Takes precedence over session_name if both are provided.

session_name
string | null

Session name. Creates a new session if not found in the workspace. Ignored if session_id is set.

Response

Successful Response

run_id
string<uuid>
required

Unique identifier for this workflow run.

status
enum<string>
required

Current run status: PENDING or RUNNING.

Available options:
pending,
running,
success,
failure,
cancelled
estimated_price_creative_units
number
required

Estimated price in Creative Units.

poll_interval_seconds
integer
required

Suggested polling interval in seconds.

created_at
string<date-time>
required

Timestamp of when the run was created.

session_id
string<uuid> | null

Session ID the run was added to, if a session was specified.