API Reference · Incidents
Create incident
Mutation
createIncidentCreates a new incident with a priority and title, optionally linked to affected services and the status pages it should be posted on.
createIncident(
organizationUUID: ID!
newIncidentSpec: NewIncidentRequest!
): Incident!Before you start
An incident always follows an incident schema. Look up schemaVersionId and priorityId with the incidentSchemas query: each of its schemas has a currentVersion with its id and the priorities you can choose from.
Service and status page IDs come from the services and statuspages queries.
Arguments
Field
Type
Returns
Field
Type
Example
mutation CreateIncident($organizationUUID: ID!, $newIncidentSpec: NewIncidentRequest!) {
createIncident(organizationUUID: $organizationUUID, newIncidentSpec: $newIncidentSpec) {
id
title
summary
createdAt
viewCount
schemaVersion {
id
version
}
priority {
id
name
order
color
icon
}
state {
id
name
order
icon
color
isDefault
isAcknowledged
isResolved
}
timings {
scheduledAt
startedAt
acknowledgedAt
resolvedAt
closedAt
}
roles {
role {
id
name
description
createdAt
updatedAt
}
}
events {
paginationMetadata {
nextPageCursor
totalCount
}
}
affectedServices {
service {
id
name
description
isDeleted
deletedAt
}
}
statuspageLinks {
statuspage {
id
staticId
name
slug
visibility
authentication
hasPassword
offerSignIn
subdomain
customDomain
domain
canEdit
viewAlertThreshold
createdAt
updatedAt
}
}
communicationChannels {
provider
channelName
channelLink
}
broadcastMessages {
id
createdAt
updatedAt
}
relatedAlerts {
paginationMetadata {
totalCount
}
}
monitorOutages {
monitor {
id
name
probeType
paused
regionScopes
availabilityPolicy
createdAt
updatedAt
deletedAt
}
}
tasks {
linkId
taskId
}
}
}Example response
{
"data": {
"createIncident": {
"id": 1,
"title": "Example title",
"summary": "Example summary",
"createdAt": "2026-01-01T12:00:00Z",
"viewCount": 1,
"schemaVersion": {
"id": "01JB3X7T9QK2M4N6P8R0S2T4V6",
"version": 1
},
"priority": {
"id": "01JB3X7T9QK2M4N6P8R0S2T4V6",
"name": "Example name",
"order": 1,
"color": "#666bff",
"icon": "Example icon"
},
"state": {
"id": "01JB3X7T9QK2M4N6P8R0S2T4V6",
"name": "Example name",
"order": 1,
"icon": "Example icon",
"color": "#666bff",
"isDefault": true,
"isAcknowledged": true,
"isResolved": true
},
"timings": {
"scheduledAt": "2026-01-01T12:00:00Z",
"startedAt": "2026-01-01T12:00:00Z",
"acknowledgedAt": "2026-01-01T12:00:00Z",
"resolvedAt": "2026-01-01T12:00:00Z",
"closedAt": "2026-01-01T12:00:00Z"
},
"roles": [
{
"role": {
"id": "01JB3X7T9QK2M4N6P8R0S2T4V6",
"name": "Example name",
"description": "Example description",
"createdAt": "2026-01-01T12:00:00Z",
"updatedAt": "2026-01-01T12:00:00Z"
}
}
],
"events": {
"paginationMetadata": {
"nextPageCursor": "Example nextPageCursor",
"totalCount": 1
}
},
"affectedServices": [
{
"service": {
"id": 1,
"name": "Example name",
"description": "Example description",
"isDeleted": true,
"deletedAt": "2026-01-01T12:00:00Z"
}
}
],
"statuspageLinks": [
{
"statuspage": {
"id": 1,
"staticId": "01JB3X7T9QK2M4N6P8R0S2T4V6",
"name": "Example name",
"slug": "Example slug",
"visibility": "PUBLIC",
"authentication": "NONE",
"hasPassword": true,
"offerSignIn": true,
"subdomain": "status.example.com",
"customDomain": "status.example.com",
"domain": "status.example.com",
"canEdit": true,
"viewAlertThreshold": 1,
"createdAt": "2026-01-01T12:00:00Z",
"updatedAt": "2026-01-01T12:00:00Z"
}
}
],
"communicationChannels": [
{
"provider": "Example provider",
"channelName": "Example channelName",
"channelLink": "Example channelLink"
}
],
"broadcastMessages": [
{
"id": "01JB3X7T9QK2M4N6P8R0S2T4V6",
"createdAt": "2026-01-01T12:00:00Z",
"updatedAt": "2026-01-01T12:00:00Z"
}
],
"relatedAlerts": {
"paginationMetadata": {
"totalCount": 1
}
},
"monitorOutages": [
{
"monitor": {
"id": "01JB3X7T9QK2M4N6P8R0S2T4V6",
"name": "Example name",
"probeType": "ICMP",
"paused": true,
"regionScopes": [
"Example regionScopes"
],
"availabilityPolicy": "ANY_UP",
"createdAt": "2026-01-01T12:00:00Z",
"updatedAt": "2026-01-01T12:00:00Z",
"deletedAt": "2026-01-01T12:00:00Z"
}
}
],
"tasks": [
{
"linkId": "01JB3X7T9QK2M4N6P8R0S2T4V6",
"taskId": "01JB3X7T9QK2M4N6P8R0S2T4V6"
}
]
}
}
}More examples
Look up schema and priority IDs
query IncidentSchemas($organizationId: ID!) {
incidentSchemas(organizationId: $organizationId) {
schemas {
name
currentVersion {
id
priorities { id name }
}
}
}
}{
"organizationId": "YOUR_ORGANIZATION_UUID"
}