Incident Roles
API endpoints for incident roles
Manage incident roles.
During an incident, you can assign responders to one of the incident roles that are
configured in your organisation settings.
Every organisation will have a special ‘lead’ role, which signifies the incident lead or
commander. This role cannot be deleted, but can be renamed in the incident.io dashboard.
The incident role object
When the role was created
Example:
"2021-08-17T13:28:57.801578Z"
Describes the purpose of the role
Minimum string length:
1Example:
"The person currently coordinating the incident"
Unique identifier for the role
Example:
"01FCNDV6P870EA6S7TK1DSYDG0"
Provided to whoever is nominated for the role. Note that this will be empty for the 'reporter' role.
Example:
"Take point on the incident; Make sure people are clear on responsibilities"
Human readable name of the incident role
Minimum string length:
1Example:
"Incident Lead"
Type of incident role
Available options:
lead, reporter, custom Example:
"lead"
Short human readable name for Slack. Note that this will be empty for the 'reporter' role.
Example:
"lead"
When the role was last updated
Example:
"2021-08-17T13:28:57.801578Z"
Was this page helpful?
{
"created_at": "2021-08-17T13:28:57.801578Z",
"description": "The person currently coordinating the incident",
"id": "01FCNDV6P870EA6S7TK1DSYDG0",
"instructions": "Take point on the incident; Make sure people are clear on responsibilities",
"name": "Incident Lead",
"role_type": "lead",
"shortform": "lead",
"updated_at": "2021-08-17T13:28:57.801578Z"
}