Skip to main content
POST
Run a workflow

Authorizations

Authorization
string
header
required

All requests to the Cortex API need to provide an Authorization: Bearer <token> header, where <token> is an API key created in the Settings page of your workspace.

Path Parameters

tagOrId
string
required

The tag or unique, auto-generated identifier for the workflow. Entity identifier - can be a tag or CID

Body

application/json
scope
GLOBAL · object
required

Scope of the workflow run (e.g., target entities)

initialContext
object
notificationRecipients
string[]

List of email addresses to notify of workflow updates.

List of email addresses to notify of workflow updates.

runAs
string

User's email to run the workflow as

Response

Workflow run started successfully

actions
object[]
required

Actions and their states

context
object
required

Context of the run

id
string
required

Id of the run

status
string
required

Status of the workflow run

variables
object
required

Variable values

workflow
object
required

Summary of the workflow

completedAt
string

Time the workflow run completed

initiatedBy
object

Who initiated the workflow run

runResponse
string
startedAt
string

Time the workflow run started

Last modified on September 29, 2026