Incident Roles V2

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.

List Incident Roles V2

List all incident roles for an organisation.

Responses
200

OK response.

get/v2/incident_roles
Request samples 
Response samples 
application/json
{
  • "incident_roles": [
    ]
}
Create Incident Roles V2
Create a new incident role


Request 
Request Body schema: application/json
required
description
required
string  non-empty 
Describes the purpose of the role


 
instructions
required
string
Provided to whoever is nominated for the role. Note that this will be empty for the 'reporter' role.


 
name
required
string  non-empty 
Human readable name of the incident role


 
shortform
required
string
Short human readable name for Slack. Note that this will be empty for the 'reporter' role.


 
Responses 
201
Created response.


post/v2/incident_roles
Request samples 
application/json
{
  • "description": "The person currently coordinating the incident",
  • "instructions": "Take point on the incident; Make sure people are clear on responsibilities",
  • "name": "Incident Lead",
  • "shortform": "lead"
}
Response samples 
application/json
{
  • "incident_role": {
    }
}
Delete Incident Roles V2
Removes an existing role


Request 
path Parameters
id
required
string
Unique identifier for the role


 
 Example:  01FCNDV6P870EA6S7TK1DSYDG0
Responses 
204
No Content response.


delete/v2/incident_roles/{id}
Request samples 
Show Incident Roles V2
Get a single incident role.


Request 
path Parameters
id
required
string
Unique identifier for the role


 
 Example:  01FCNDV6P870EA6S7TK1DSYDG0
Responses 
200
OK response.


get/v2/incident_roles/{id}
Request samples 
Response samples 
application/json
{
  • "incident_role": {
    }
}
Update Incident Roles V2
Update an existing incident role


Request 
path Parameters
id
required
string
Unique identifier for the role


 
 Example:  01FCNDV6P870EA6S7TK1DSYDG0
Request Body schema: application/json
required
description
required
string  non-empty 
Describes the purpose of the role


 
instructions
required
string
Provided to whoever is nominated for the role. Note that this will be empty for the 'reporter' role.


 
name
required
string  non-empty 
Human readable name of the incident role


 
shortform
required
string
Short human readable name for Slack. Note that this will be empty for the 'reporter' role.


 
Responses 
200
OK response.


put/v2/incident_roles/{id}
Request samples 
application/json
{
  • "description": "The person currently coordinating the incident",
  • "instructions": "Take point on the incident; Make sure people are clear on responsibilities",
  • "name": "Incident Lead",
  • "shortform": "lead"
}
Response samples 
application/json
{
  • "incident_role": {
    }
}
➔ Next to Incident Statuses V1