API Reference · Incidents · Roles & responders
Create incident role
Mutation
createIncidentRoleCreates an incident role. Subject to the plan's quota for incident roles.
createIncidentRole(
organizationUUID: ID!
incidentRoleSpec: IncidentRoleSpec!
): IncidentRole!Arguments
Field
Type
Returns
Field
Type
Example
mutation CreateIncidentRole($organizationUUID: ID!, $incidentRoleSpec: IncidentRoleSpec!) {
createIncidentRole(organizationUUID: $organizationUUID, incidentRoleSpec: $incidentRoleSpec) {
id
name
description
createdAt
updatedAt
}
}Example response
{
"data": {
"createIncidentRole": {
"id": "01JB3X7T9QK2M4N6P8R0S2T4V6",
"name": "Example name",
"description": "Example description",
"createdAt": "2026-01-01T12:00:00Z",
"updatedAt": "2026-01-01T12:00:00Z"
}
}
}