Skip to main content
POST
/
v1
/
incidents
Creates an incident
curl --request POST \
  --url https://api.rootly.com/v1/incidents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/vnd.api+json' \
  --data '
{
  "data": {
    "type": "incidents",
    "attributes": {
      "title": "<string>",
      "kind": "normal",
      "parent_incident_id": "<string>",
      "duplicate_incident_id": "<string>",
      "private": false,
      "summary": "<string>",
      "user_id": "<string>",
      "severity_id": "<string>",
      "public_title": "<string>",
      "alert_ids": [
        "<string>"
      ],
      "environment_ids": [
        "<string>"
      ],
      "incident_type_ids": [
        "<string>"
      ],
      "service_ids": [
        "<string>"
      ],
      "functionality_ids": [
        "<string>"
      ],
      "group_ids": [
        "<string>"
      ],
      "cause_ids": [
        "<string>"
      ],
      "muted_service_ids": [
        "<string>"
      ],
      "labels": {},
      "slack_channel_name": "<string>",
      "slack_channel_id": "<string>",
      "slack_channel_url": "<string>",
      "slack_channel_archived": true,
      "google_drive_parent_id": "<string>",
      "google_drive_url": "<string>",
      "jira_issue_key": "<string>",
      "jira_issue_id": "<string>",
      "jira_issue_url": "<string>",
      "notify_emails": [
        "<string>"
      ],
      "status": "in_triage",
      "url": "<string>",
      "scheduled_for": "<string>",
      "scheduled_until": "<string>",
      "in_triage_at": "<string>",
      "started_at": "<string>",
      "detected_at": "<string>",
      "acknowledged_at": "<string>",
      "mitigated_at": "<string>",
      "resolved_at": "<string>",
      "closed_at": "<string>",
      "cancelled_at": "<string>"
    }
  }
}
'
{
  "data": {
    "id": "e2d42753-5dd0-4c25-8b3a-472200a971a8",
    "type": "incidents",
    "attributes": {
      "parent_incident_id": null,
      "sequential_id": 11,
      "title": "Oh no! Something is broken",
      "slug": "oh-no-something-is-broken",
      "kind": "normal",
      "private": false,
      "summary": "this is the description and there are new lines\n\nthis is the next line\n\nthis is the 3rd line",
      "status": "started",
      "source": "api",
      "url": "http://localhost:3001/account/incidents/11-oh-no-something-is-broken",
      "short_url": null,
      "user": {
        "data": {
          "id": "680",
          "type": "users",
          "attributes": {
            "name": "Tyesha Stehr",
            "email": "[email protected]",
            "phone": null,
            "phone_2": null,
            "first_name": "Tyesha",
            "last_name": "Stehr",
            "full_name": "Tyesha Stehr",
            "full_name_with_team": "[Fritsch, Stark and Schamberger] Tyesha Stehr",
            "slack_id": null,
            "time_zone": "Etc/UTC",
            "updated_at": "2026-02-05T21:42:43.370-08:00",
            "created_at": "2026-02-05T21:42:27.760-08:00"
          },
          "relationships": {
            "email_addresses": {
              "data": [
                {
                  "id": "63b6446f-b360-442d-9348-da8c50eaae52",
                  "type": "user_email_addresses"
                }
              ]
            },
            "phone_numbers": {
              "data": []
            },
            "devices": {
              "data": []
            },
            "role": {
              "data": {
                "id": "a2f780b4-d260-4039-8336-1be29a69442d",
                "alerts_permissions": [
                  "create",
                  "read"
                ],
                "api_keys_permissions": [
                  "create",
                  "update",
                  "read",
                  "delete"
                ],
                "audits_permissions": [],
                "billing_permissions": [],
                "catalogs_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "communication_permissions": [
                  "read"
                ],
                "created_at": "2026-02-05T21:42:27.879-08:00",
                "deleted_at": null,
                "display_order": 2,
                "edge_connector_permissions": [],
                "environments_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "form_fields_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "functionalities_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "groups_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "incident_causes_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "incident_communication_permissions": [
                  "read"
                ],
                "incident_feedbacks_permissions": [
                  "read",
                  "create",
                  "update"
                ],
                "incident_permission_set_id": "c1d80c24-c997-4e04-b820-91dd01d71c33",
                "incident_roles_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "incident_types_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "incidents_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "integrations_permissions": [],
                "invitations_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "is_deletable": false,
                "is_editable": true,
                "name": "user",
                "paging_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "playbooks_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "private_incidents_permissions": [],
                "pulses_permissions": [
                  "create",
                  "update",
                  "read"
                ],
                "retrospective_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "roles_permissions": [],
                "secrets_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "services_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "severities_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "slug": "user",
                "status_pages_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "sub_statuses_permissions": [
                  "read"
                ],
                "team_id": 393,
                "updated_at": "2026-02-05T21:42:27.879-08:00",
                "webhooks_permissions": [],
                "workflows_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ]
              }
            },
            "on_call_role": {
              "data": {
                "id": "fde3b313-8506-487b-ac1f-0561ef479cf7",
                "alert_fields_permissions": [],
                "alert_groups_permissions": [],
                "alert_routing_rules_permissions": [],
                "alert_sources_permissions": [],
                "alert_urgency_permissions": [],
                "alerts_permissions": [],
                "api_keys_permissions": [],
                "audits_permissions": [],
                "contacts_permissions": [],
                "created_at": "2026-02-05T21:42:27.891-08:00",
                "deleted_at": null,
                "escalation_policies_permissions": [],
                "groups_permissions": [],
                "heartbeats_permissions": [],
                "integrations_permissions": [],
                "invitations_permissions": [],
                "live_call_routing_permissions": [],
                "name": "None",
                "on_call_readiness_report_permissions": [],
                "on_call_roles_permissions": [],
                "schedule_override_permissions": [],
                "schedules_permissions": [],
                "services_permissions": [],
                "shift_overrides_permissions": [],
                "slug": "none",
                "system_role": "no_access",
                "team_id": 393,
                "updated_at": "2026-02-05T21:42:27.891-08:00",
                "webhooks_permissions": [],
                "workflows_permissions": []
              }
            },
            "teams": {
              "data": []
            },
            "schedules": {
              "data": []
            },
            "notification_rules": {
              "data": [
                {
                  "id": "b980f8d7-2fba-40f0-a918-ec5d21f3ffbb",
                  "type": "user_notification_rules"
                },
                {
                  "id": "bd3c43e4-8ffc-49dd-b8f8-22fe834542df",
                  "type": "user_notification_rules"
                }
              ]
            }
          }
        }
      },
      "severity": {
        "data": {
          "id": "1dd589b8-1738-4f7a-8e65-93da9a817650",
          "type": "severities",
          "attributes": {
            "name": "3ol0s",
            "slug": "3ol0s",
            "description": "Ex quod eos error.",
            "severity": "medium",
            "color": "#E58A1F",
            "position": 1,
            "notify_emails": [],
            "slack_channels": [],
            "slack_aliases": [],
            "created_at": "2026-02-05T21:42:33.245-08:00",
            "updated_at": "2026-02-05T21:42:33.245-08:00"
          }
        }
      },
      "in_triage_by": null,
      "started_by": {
        "data": {
          "id": "680",
          "type": "users",
          "attributes": {
            "name": "Tyesha Stehr",
            "email": "[email protected]",
            "phone": null,
            "phone_2": null,
            "first_name": "Tyesha",
            "last_name": "Stehr",
            "full_name": "Tyesha Stehr",
            "full_name_with_team": "[Fritsch, Stark and Schamberger] Tyesha Stehr",
            "slack_id": null,
            "time_zone": "Etc/UTC",
            "updated_at": "2026-02-05T21:42:43.370-08:00",
            "created_at": "2026-02-05T21:42:27.760-08:00"
          },
          "relationships": {
            "email_addresses": {
              "data": [
                {
                  "id": "63b6446f-b360-442d-9348-da8c50eaae52",
                  "type": "user_email_addresses"
                }
              ]
            },
            "phone_numbers": {
              "data": []
            },
            "devices": {
              "data": []
            },
            "role": {
              "data": {
                "id": "a2f780b4-d260-4039-8336-1be29a69442d",
                "alerts_permissions": [
                  "create",
                  "read"
                ],
                "api_keys_permissions": [
                  "create",
                  "update",
                  "read",
                  "delete"
                ],
                "audits_permissions": [],
                "billing_permissions": [],
                "catalogs_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "communication_permissions": [
                  "read"
                ],
                "created_at": "2026-02-05T21:42:27.879-08:00",
                "deleted_at": null,
                "display_order": 2,
                "edge_connector_permissions": [],
                "environments_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "form_fields_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "functionalities_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "groups_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "incident_causes_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "incident_communication_permissions": [
                  "read"
                ],
                "incident_feedbacks_permissions": [
                  "read",
                  "create",
                  "update"
                ],
                "incident_permission_set_id": "c1d80c24-c997-4e04-b820-91dd01d71c33",
                "incident_roles_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "incident_types_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "incidents_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "integrations_permissions": [],
                "invitations_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "is_deletable": false,
                "is_editable": true,
                "name": "user",
                "paging_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "playbooks_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "private_incidents_permissions": [],
                "pulses_permissions": [
                  "create",
                  "update",
                  "read"
                ],
                "retrospective_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "roles_permissions": [],
                "secrets_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "services_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "severities_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "slug": "user",
                "status_pages_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "sub_statuses_permissions": [
                  "read"
                ],
                "team_id": 393,
                "updated_at": "2026-02-05T21:42:27.879-08:00",
                "webhooks_permissions": [],
                "workflows_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ]
              }
            },
            "on_call_role": {
              "data": {
                "id": "fde3b313-8506-487b-ac1f-0561ef479cf7",
                "alert_fields_permissions": [],
                "alert_groups_permissions": [],
                "alert_routing_rules_permissions": [],
                "alert_sources_permissions": [],
                "alert_urgency_permissions": [],
                "alerts_permissions": [],
                "api_keys_permissions": [],
                "audits_permissions": [],
                "contacts_permissions": [],
                "created_at": "2026-02-05T21:42:27.891-08:00",
                "deleted_at": null,
                "escalation_policies_permissions": [],
                "groups_permissions": [],
                "heartbeats_permissions": [],
                "integrations_permissions": [],
                "invitations_permissions": [],
                "live_call_routing_permissions": [],
                "name": "None",
                "on_call_readiness_report_permissions": [],
                "on_call_roles_permissions": [],
                "schedule_override_permissions": [],
                "schedules_permissions": [],
                "services_permissions": [],
                "shift_overrides_permissions": [],
                "slug": "none",
                "system_role": "no_access",
                "team_id": 393,
                "updated_at": "2026-02-05T21:42:27.891-08:00",
                "webhooks_permissions": [],
                "workflows_permissions": []
              }
            },
            "teams": {
              "data": []
            },
            "schedules": {
              "data": []
            },
            "notification_rules": {
              "data": [
                {
                  "id": "b980f8d7-2fba-40f0-a918-ec5d21f3ffbb",
                  "type": "user_notification_rules"
                },
                {
                  "id": "bd3c43e4-8ffc-49dd-b8f8-22fe834542df",
                  "type": "user_notification_rules"
                }
              ]
            }
          }
        }
      },
      "mitigated_by": null,
      "resolved_by": null,
      "closed_by": null,
      "cancelled_by": null,
      "mitigation_message": null,
      "resolution_message": null,
      "cancellation_message": null,
      "public_title": "Public incident notification",
      "duplicate_incident_id": null,
      "retrospective_progress_status": "not_started",
      "zoom_meeting_id": null,
      "zoom_meeting_start_url": null,
      "zoom_meeting_join_url": null,
      "zoom_meeting_password": null,
      "zoom_meeting_pstn_password": null,
      "zoom_meeting_h323_password": null,
      "zoom_meeting_global_dial_in_numbers": [],
      "shortcut_story_id": null,
      "shortcut_story_url": null,
      "shortcut_task_id": null,
      "shortcut_task_url": null,
      "asana_task_id": null,
      "asana_task_url": null,
      "github_issue_id": null,
      "github_issue_url": null,
      "gitlab_issue_id": null,
      "gitlab_issue_url": null,
      "jira_issue_key": "PROJ-123",
      "jira_issue_id": "10001",
      "jira_issue_url": "https://jira.example.com/browse/PROJ-123",
      "google_meeting_id": null,
      "google_meeting_url": null,
      "trello_card_id": null,
      "trello_card_url": null,
      "linear_issue_id": null,
      "linear_issue_url": null,
      "zendesk_ticket_id": null,
      "zendesk_ticket_url": null,
      "motion_task_id": null,
      "motion_task_url": null,
      "clickup_task_id": null,
      "clickup_task_url": null,
      "slack_channel_name": "incident-response",
      "slack_channel_id": "C123456789",
      "slack_channel_url": "https://team.slack.com/channels/incident-response",
      "slack_channel_short_url": null,
      "slack_channel_deep_link": null,
      "slack_channel_archived": false,
      "slack_last_message_ts": null,
      "service_now_incident_id": null,
      "service_now_incident_key": null,
      "service_now_incident_url": null,
      "opsgenie_incident_id": null,
      "opsgenie_incident_url": null,
      "opsgenie_alert_id": null,
      "opsgenie_alert_url": null,
      "victor_ops_incident_id": null,
      "victor_ops_incident_url": null,
      "pagerduty_incident_id": null,
      "pagerduty_incident_number": null,
      "pagerduty_incident_url": null,
      "mattermost_channel_id": null,
      "mattermost_channel_name": null,
      "mattermost_channel_url": null,
      "confluence_page_id": null,
      "confluence_page_url": null,
      "quip_page_id": null,
      "quip_page_url": null,
      "airtable_base_key": null,
      "airtable_table_name": null,
      "airtable_record_id": null,
      "airtable_record_url": null,
      "google_drive_id": null,
      "google_drive_parent_id": null,
      "google_drive_url": "https://docs.google.com/document/d/1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms",
      "sharepoint_page_id": null,
      "sharepoint_page_url": null,
      "datadog_notebook_id": null,
      "datadog_notebook_url": null,
      "freshservice_ticket_id": null,
      "freshservice_ticket_url": null,
      "freshservice_task_id": null,
      "freshservice_task_url": null,
      "scheduled_for": null,
      "scheduled_until": null,
      "in_triage_at": null,
      "started_at": "2026-02-05T21:42:43.513-08:00",
      "detected_at": null,
      "acknowledged_at": null,
      "mitigated_at": null,
      "resolved_at": null,
      "closed_at": null,
      "cancelled_at": null,
      "created_at": "2026-02-05T21:42:43.559-08:00",
      "updated_at": "2026-02-05T21:42:43.663-08:00",
      "muted_service_ids": [],
      "labels": {
        "platform": "windows",
        "version": "1.12",
        "CaseSensitive": "preserve"
      }
    },
    "relationships": {
      "causes": {
        "data": [
          {
            "id": "c2e754db-2332-4142-8566-8b12b3627152",
            "type": "causes"
          },
          {
            "id": "1cc0848a-2580-4897-9676-e08e76f81fa3",
            "type": "causes"
          }
        ]
      },
      "subscribers": {
        "data": []
      },
      "roles": {
        "data": [
          {
            "id": "aaf8ec38-4850-47a9-ae16-cbfb23323ae8",
            "type": "incident_role_assignments"
          }
        ]
      },
      "environments": {
        "data": [
          {
            "id": "b7082bce-3de7-4184-b5d4-9a62eaf29d15",
            "type": "environments"
          },
          {
            "id": "4ff21a05-615d-4b8f-8257-6f2cd4217358",
            "type": "environments"
          }
        ]
      },
      "incident_types": {
        "data": [
          {
            "id": "9b45fac1-203c-42f4-b431-a9aefa194af8",
            "type": "incident_types"
          },
          {
            "id": "0f782c89-2ea5-4230-8669-d85092b899b9",
            "type": "incident_types"
          }
        ]
      },
      "services": {
        "data": [
          {
            "id": "8316d9dd-6a23-43b7-bd63-83340b582de3",
            "type": "services"
          },
          {
            "id": "848ed4b5-0491-4b82-ac6b-a1386edcedd8",
            "type": "services"
          }
        ]
      },
      "functionalities": {
        "data": [
          {
            "id": "1a5181e2-47b6-42dc-a5c7-cf2724e9e335",
            "type": "functionalities"
          },
          {
            "id": "ae88d39c-c98d-4f94-a2e4-b9081dc737db",
            "type": "functionalities"
          }
        ]
      },
      "groups": {
        "data": [
          {
            "id": "eb9ff2c0-7a8c-4769-887c-2ae4485756e1",
            "type": "groups"
          },
          {
            "id": "a18ae9f7-e3fc-4836-9e7c-bcbd312f9cdc",
            "type": "groups"
          }
        ]
      },
      "events": {
        "data": [
          {
            "id": "30caaa24-5f63-4b2d-91ba-111fc6ef3919",
            "type": "incident_events"
          },
          {
            "id": "d5070d58-6eaf-4e82-86cb-8d6cf21215d1",
            "type": "incident_events"
          },
          {
            "id": "789fc894-c212-4b00-8f51-0871faae0afe",
            "type": "incident_events"
          },
          {
            "id": "bcb49b5b-f629-4a98-896c-5b6acdd63a81",
            "type": "incident_events"
          }
        ]
      },
      "action_items": {
        "data": []
      },
      "custom_field_selections": {
        "data": []
      },
      "feedbacks": {
        "data": []
      },
      "attachments": {
        "data": []
      },
      "slack_messages": {
        "data": []
      },
      "alerts": {
        "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

incident created

data
object
required