Skip to main content
POST
/
v1
/
workflows
/
{workflow_id}
/
workflow_runs
Creates a workflow run
curl --request POST \
  --url https://api.rootly.com/v1/workflows/{workflow_id}/workflow_runs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/vnd.api+json' \
  --data '
{
  "data": {
    "type": "workflow_runs",
    "attributes": {
      "immediate": true,
      "check_conditions": false,
      "context": {}
    }
  }
}
'
{
  "data": {
    "id": "79baf408-866b-4e4a-b67e-e0dbcda63927",
    "type": "workflow_runs",
    "attributes": {
      "kind": "incident",
      "status": "queued",
      "status_message": null,
      "triggered_by": "user",
      "user_id": 194,
      "queued_at": "2025-12-10T18:24:59.382-08:00",
      "started_at": null,
      "completed_at": null,
      "failed_at": null,
      "canceled_at": null,
      "updated_at": "2025-12-10T18:24:59.382-08:00",
      "created_at": "2025-12-10T18:24:59.382-08:00",
      "incident_id": "c456eaa4-7d1a-489c-ac03-2aa460324041",
      "post_mortem_id": null,
      "action_item_id": null,
      "alert_id": null,
      "pulse_id": null,
      "workflow_id": "ab628c2f-d9a4-40cc-a2c3-ad5606fcde7e",
      "workflow_name": "The Usual Suspects"
    },
    "relationships": {
      "task_runs": {
        "data": []
      }
    }
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
workflow_id
string
required

Body

application/vnd.api+json
​
data
object
required

Response

workflow run created

​
data
object
required