POST
/
v1
/
workflows
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": "fb8f9dec-dff1-446d-83a9-8706eba97731",
    "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": "bdb202bc-0a31-4ab7-8f11-f0bd6a655c5a",
      "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-03-28T23:00:39.631-07:00",
      "created_at": "2025-03-28T23:00:39.631-07:00"
    },
    "relationships": {
      "custom_field_selections": {
        "data": []
      },
      "workflow_tasks": {
        "data": []
      },
      "workflow_runs": {
        "data": []
      }
    }
  }
}

Authorizations

Authorization
string
header
required

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

Body

application/vnd.api+json
data
object
required

Response

201
application/vnd.api+json
admins can set 'locked' while creating a workflow
data
object
required