Skip to main content
POST
/
api
/
v1
/
workflow
/
{workflow_id}
/
runs
Create Workflow Run
curl --request POST \
  --url https://app.dograh.com/api/v1/workflow/{workflow_id}/runs \
  --header 'Content-Type: application/json' \
  --data '
{
  "mode": "<string>",
  "name": "<string>"
}
'
{
  "id": 123,
  "workflow_id": 123,
  "name": "<string>",
  "mode": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "definition_id": 123,
  "initial_context": {}
}
Creates a test execution of the workflow. No outbound call is placed — this is useful for validating agent behavior, checking prompt outputs, and testing tool integrations before going live.

Headers

​
authorization
string | null
​
X-API-Key
string | null

Path Parameters

​
workflow_id
integer
required

Body

application/json
​
mode
string
required
​
name
string
required

Response

Successful Response

​
id
integer
required
​
workflow_id
integer
required
​
name
string
required
​
mode
string
required
​
created_at
string<date-time>
required
​
definition_id
integer
required
​
initial_context
Initial Context · object