Skip to main content
POST
/
v1
/
workspaces
/
{workspace_id}
/
workflows
/
{workflow_id}
/
runs
Execute workflow
curl --request POST \
  --url https://api.app.layer.ai/api/v1/workspaces/{workspace_id}/workflows/{workflow_id}/runs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "inputs": {},
  "session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "session_name": "<string>"
}
'
{
  "run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "pending",
  "estimated_price_creative_units": 123,
  "poll_interval_seconds": 123,
  "created_at": "2023-11-07T05:31:56Z",
  "session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

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.