POST
/
v1
/
incidents
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>",
      "environment_ids": [
        "<string>"
      ],
      "incident_type_ids": [
        "<string>"
      ],
      "service_ids": [
        "<string>"
      ],
      "functionality_ids": [
        "<string>"
      ],
      "group_ids": [
        "<string>"
      ],
      "cause_ids": [
        "<string>"
      ],
      "labels": {},
      "slack_channel_name": "<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>",
      "cancelled_at": "<string>"
    }
  }
}'
{
  "data": {
    "id": "0e0b8428-bbe9-4784-a9b6-db5f7e7992e3",
    "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": "290",
          "type": "users",
          "attributes": {
            "name": "Darron Kutch",
            "email": "devon.nitzsche@ratke-rolfson.test",
            "phone": null,
            "phone_2": null,
            "full_name": "Darron Kutch",
            "full_name_with_team": "[Block-Harris] Darron Kutch",
            "slack_id": null,
            "time_zone": "UTC",
            "updated_at": "2025-04-18T09:50:26.222-07:00",
            "created_at": "2025-04-18T09:50:11.121-07:00"
          },
          "relationships": {
            "email_addresses": {
              "data": [
                {
                  "id": "bfaa48e8-9fb6-4fce-a16d-ce43c6663196",
                  "type": "user_email_addresses"
                }
              ]
            },
            "phone_numbers": {
              "data": []
            },
            "devices": {
              "data": []
            }
          }
        }
      },
      "severity": {
        "data": {
          "id": "4cbd78be-ac62-4ac8-8292-15ffc66a3b44",
          "type": "severities",
          "attributes": {
            "name": "w0vfc",
            "slug": "w0vfc",
            "description": "Quibusdam et dolores atque.",
            "severity": "medium",
            "color": "#E58A1F",
            "position": 1,
            "notify_emails": [],
            "slack_channels": [],
            "slack_aliases": [],
            "created_at": "2025-04-18T09:50:19.117-07:00",
            "updated_at": "2025-04-18T09:50:19.117-07:00"
          }
        }
      },
      "in_triage_by": null,
      "started_by": {
        "data": {
          "id": "290",
          "type": "users",
          "attributes": {
            "name": "Darron Kutch",
            "email": "devon.nitzsche@ratke-rolfson.test",
            "phone": null,
            "phone_2": null,
            "full_name": "Darron Kutch",
            "full_name_with_team": "[Block-Harris] Darron Kutch",
            "slack_id": null,
            "time_zone": "UTC",
            "updated_at": "2025-04-18T09:50:26.222-07:00",
            "created_at": "2025-04-18T09:50:11.121-07:00"
          },
          "relationships": {
            "email_addresses": {
              "data": [
                {
                  "id": "bfaa48e8-9fb6-4fce-a16d-ce43c6663196",
                  "type": "user_email_addresses"
                }
              ]
            },
            "phone_numbers": {
              "data": []
            },
            "devices": {
              "data": []
            }
          }
        }
      },
      "mitigated_by": null,
      "resolved_by": null,
      "closed_by": null,
      "cancelled_by": null,
      "mitigation_message": null,
      "resolution_message": null,
      "cancellation_message": null,
      "public_title": null,
      "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": null,
      "jira_issue_id": null,
      "jira_issue_url": null,
      "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": null,
      "slack_channel_id": null,
      "slack_channel_url": null,
      "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": null,
      "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": "2025-04-18T09:50:26.407-07:00",
      "detected_at": null,
      "acknowledged_at": null,
      "mitigated_at": null,
      "resolved_at": null,
      "closed_at": null,
      "cancelled_at": null,
      "created_at": "2025-04-18T09:50:26.472-07:00",
      "updated_at": "2025-04-18T09:50:26.623-07:00",
      "labels": {
        "platform": "windows",
        "version": "1.12",
        "CaseSensitive": "preserve"
      }
    },
    "relationships": {
      "causes": {
        "data": [
          {
            "id": "401d7f12-d789-4b1d-b214-cb77c363515d",
            "type": "causes"
          },
          {
            "id": "9de43eff-6644-4d88-8182-d13e8a4a3e85",
            "type": "causes"
          }
        ]
      },
      "subscribers": {
        "data": []
      },
      "roles": {
        "data": [
          {
            "id": "597cbe4c-1980-467e-931e-c7125e993051",
            "type": "incident_role_assignments"
          }
        ]
      },
      "environments": {
        "data": [
          {
            "id": "90a7caa1-9d04-400e-a893-8e32a178679c",
            "type": "environments"
          },
          {
            "id": "ae1dfaea-2ce7-4576-be9f-98696c99cee8",
            "type": "environments"
          }
        ]
      },
      "incident_types": {
        "data": [
          {
            "id": "c860ef92-0dd6-41bb-aafe-3487fe81f2e4",
            "type": "incident_types"
          },
          {
            "id": "ad5ac30d-b724-49db-81d8-370462877009",
            "type": "incident_types"
          }
        ]
      },
      "services": {
        "data": [
          {
            "id": "cd08267d-53d8-473f-a954-14f1040c27f0",
            "type": "services"
          },
          {
            "id": "4a16042e-f4f9-49d1-aea6-d296bffbb6c9",
            "type": "services"
          }
        ]
      },
      "functionalities": {
        "data": [
          {
            "id": "da63a8db-6c2d-4240-b322-8de031724987",
            "type": "functionalities"
          },
          {
            "id": "23f80ccc-4985-4579-bceb-ab3f3b506559",
            "type": "functionalities"
          }
        ]
      },
      "groups": {
        "data": [
          {
            "id": "014af569-603b-4a23-8e1a-2441daabc29e",
            "type": "groups"
          },
          {
            "id": "73c25da8-f876-458b-a9bd-9605297c6ee6",
            "type": "groups"
          }
        ]
      },
      "events": {
        "data": [
          {
            "id": "18edeb7a-afee-48b4-9846-ee273545e059",
            "type": "incident_events"
          },
          {
            "id": "feb86087-381e-402d-8ac9-b392eb5d3af2",
            "type": "incident_events"
          },
          {
            "id": "800e0b87-0669-4e67-9475-8fcb21d915d5",
            "type": "incident_events"
          },
          {
            "id": "4fc71421-9adf-4486-b683-0a38a24d7722",
            "type": "incident_events"
          }
        ]
      },
      "action_items": {
        "data": []
      },
      "custom_field_selections": {
        "data": []
      },
      "feedbacks": {
        "data": []
      },
      "attachments": {
        "data": []
      },
      "slack_messages": {
        "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
incident created
​
data
object
required

Was this page helpful?