Creates a new workflow from provided data
curl --request POST \
--url https://api.rootly.com/v1/workflows \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/vnd.api+json' \
--data '{
"data": {
"type": "workflows",
"attributes": {
"name": "<string>",
"slug": "<string>",
"description": "<string>",
"command": "<string>",
"command_feedback_enabled": true,
"wait": "<string>",
"priority": "low",
"repeat_every_duration": "<string>",
"repeat_condition_duration_since_first_run": "<string>",
"repeat_condition_number_of_repeats": 123,
"continuously_repeat": true,
"repeat_on": [
"S"
],
"enabled": true,
"locked": true,
"position": 123,
"workflow_group_id": "<string>",
"trigger_params": {
"trigger_type": "incident",
"triggers": [
"<string>"
],
"incident_visibilities": [
true
],
"incident_kinds": [
"test"
],
"incident_statuses": [
"in_triage"
],
"incident_inactivity_duration": "<any>",
"incident_condition": "ALL",
"incident_condition_visibility": "ANY",
"incident_condition_kind": "IS",
"incident_condition_status": "ANY",
"incident_condition_sub_status": "ANY",
"incident_condition_environment": "ANY",
"incident_condition_severity": "ANY",
"incident_condition_incident_type": "ANY",
"incident_condition_incident_roles": "ANY",
"incident_condition_service": "ANY",
"incident_condition_functionality": "ANY",
"incident_condition_group": "ANY",
"incident_condition_cause": "ANY",
"incident_post_mortem_condition_cause": "ANY",
"incident_condition_summary": "<any>",
"incident_condition_started_at": "<any>",
"incident_condition_detected_at": "<any>",
"incident_condition_acknowledged_at": "<any>",
"incident_condition_mitigated_at": "<any>",
"incident_condition_resolved_at": "<any>",
"incident_conditional_inactivity": "<any>"
},
"environment_ids": [
"<string>"
],
"severity_ids": [
"<string>"
],
"incident_type_ids": [
"<string>"
],
"incident_role_ids": [
"<string>"
],
"service_ids": [
"<string>"
],
"functionality_ids": [
"<string>"
],
"group_ids": [
"<string>"
],
"cause_ids": [
"<string>"
],
"sub_status_ids": [
"<string>"
]
}
}
}'
{
"data": {
"id": "4fd44eed-7123-435a-a7d6-c6b84b6d4242",
"type": "workflows",
"attributes": {
"name": "Test",
"slug": "test",
"description": null,
"command": "incident-test",
"command_feedback_enabled": true,
"repeat_every_duration": null,
"repeat_condition_duration_since_first_run": null,
"repeat_condition_number_of_repeats": 0,
"continuously_repeat": false,
"repeat_on": [],
"wait": null,
"enabled": true,
"locked": true,
"position": 1,
"workflow_group_id": "85759e3a-4e6a-4b7a-a78f-aa42624d8f5d",
"trigger_params": {
"trigger_type": "incident",
"triggers": [],
"incident_visibilities": [],
"incident_kinds": [
"normal"
],
"incident_statuses": [],
"incident_inactivity_duration": null,
"incident_condition": "ALL",
"incident_condition_visibility": "ANY",
"incident_condition_kind": "IS",
"incident_condition_status": "ANY",
"incident_condition_sub_status": "ANY",
"incident_condition_environment": "ANY",
"incident_condition_severity": "ANY",
"incident_condition_incident_type": "ANY",
"incident_condition_incident_roles": "ANY",
"incident_condition_service": "ANY",
"incident_condition_functionality": "ANY",
"incident_condition_group": "ANY",
"incident_condition_cause": "ANY",
"incident_condition_summary": null,
"incident_condition_started_at": null,
"incident_condition_detected_at": null,
"incident_condition_acknowledged_at": null,
"incident_condition_mitigated_at": null,
"incident_condition_resolved_at": null,
"incident_conditional_inactivity": null,
"incident_post_mortem_condition_cause": "ANY"
},
"severity_ids": [],
"environment_ids": [],
"incident_type_ids": [],
"incident_role_ids": [],
"service_ids": [],
"functionality_ids": [],
"group_ids": [],
"updated_at": "2025-07-18T16:36:13.945-07:00",
"created_at": "2025-07-18T16:36:13.945-07:00"
},
"relationships": {
"custom_field_selections": {
"data": []
},
"workflow_tasks": {
"data": []
},
"workflow_runs": {
"data": []
}
}
}
}
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
admins can set 'locked' while creating a workflow
The response is of type object
.
Was this page helpful?
curl --request POST \
--url https://api.rootly.com/v1/workflows \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/vnd.api+json' \
--data '{
"data": {
"type": "workflows",
"attributes": {
"name": "<string>",
"slug": "<string>",
"description": "<string>",
"command": "<string>",
"command_feedback_enabled": true,
"wait": "<string>",
"priority": "low",
"repeat_every_duration": "<string>",
"repeat_condition_duration_since_first_run": "<string>",
"repeat_condition_number_of_repeats": 123,
"continuously_repeat": true,
"repeat_on": [
"S"
],
"enabled": true,
"locked": true,
"position": 123,
"workflow_group_id": "<string>",
"trigger_params": {
"trigger_type": "incident",
"triggers": [
"<string>"
],
"incident_visibilities": [
true
],
"incident_kinds": [
"test"
],
"incident_statuses": [
"in_triage"
],
"incident_inactivity_duration": "<any>",
"incident_condition": "ALL",
"incident_condition_visibility": "ANY",
"incident_condition_kind": "IS",
"incident_condition_status": "ANY",
"incident_condition_sub_status": "ANY",
"incident_condition_environment": "ANY",
"incident_condition_severity": "ANY",
"incident_condition_incident_type": "ANY",
"incident_condition_incident_roles": "ANY",
"incident_condition_service": "ANY",
"incident_condition_functionality": "ANY",
"incident_condition_group": "ANY",
"incident_condition_cause": "ANY",
"incident_post_mortem_condition_cause": "ANY",
"incident_condition_summary": "<any>",
"incident_condition_started_at": "<any>",
"incident_condition_detected_at": "<any>",
"incident_condition_acknowledged_at": "<any>",
"incident_condition_mitigated_at": "<any>",
"incident_condition_resolved_at": "<any>",
"incident_conditional_inactivity": "<any>"
},
"environment_ids": [
"<string>"
],
"severity_ids": [
"<string>"
],
"incident_type_ids": [
"<string>"
],
"incident_role_ids": [
"<string>"
],
"service_ids": [
"<string>"
],
"functionality_ids": [
"<string>"
],
"group_ids": [
"<string>"
],
"cause_ids": [
"<string>"
],
"sub_status_ids": [
"<string>"
]
}
}
}'
{
"data": {
"id": "4fd44eed-7123-435a-a7d6-c6b84b6d4242",
"type": "workflows",
"attributes": {
"name": "Test",
"slug": "test",
"description": null,
"command": "incident-test",
"command_feedback_enabled": true,
"repeat_every_duration": null,
"repeat_condition_duration_since_first_run": null,
"repeat_condition_number_of_repeats": 0,
"continuously_repeat": false,
"repeat_on": [],
"wait": null,
"enabled": true,
"locked": true,
"position": 1,
"workflow_group_id": "85759e3a-4e6a-4b7a-a78f-aa42624d8f5d",
"trigger_params": {
"trigger_type": "incident",
"triggers": [],
"incident_visibilities": [],
"incident_kinds": [
"normal"
],
"incident_statuses": [],
"incident_inactivity_duration": null,
"incident_condition": "ALL",
"incident_condition_visibility": "ANY",
"incident_condition_kind": "IS",
"incident_condition_status": "ANY",
"incident_condition_sub_status": "ANY",
"incident_condition_environment": "ANY",
"incident_condition_severity": "ANY",
"incident_condition_incident_type": "ANY",
"incident_condition_incident_roles": "ANY",
"incident_condition_service": "ANY",
"incident_condition_functionality": "ANY",
"incident_condition_group": "ANY",
"incident_condition_cause": "ANY",
"incident_condition_summary": null,
"incident_condition_started_at": null,
"incident_condition_detected_at": null,
"incident_condition_acknowledged_at": null,
"incident_condition_mitigated_at": null,
"incident_condition_resolved_at": null,
"incident_conditional_inactivity": null,
"incident_post_mortem_condition_cause": "ANY"
},
"severity_ids": [],
"environment_ids": [],
"incident_type_ids": [],
"incident_role_ids": [],
"service_ids": [],
"functionality_ids": [],
"group_ids": [],
"updated_at": "2025-07-18T16:36:13.945-07:00",
"created_at": "2025-07-18T16:36:13.945-07:00"
},
"relationships": {
"custom_field_selections": {
"data": []
},
"workflow_tasks": {
"data": []
},
"workflow_runs": {
"data": []
}
}
}
}