Creates a new incident role from provided data
curl --request POST \
--url https://api.rootly.com/v1/incident_roles \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/vnd.api+json' \
--data '
{
"data": {
"type": "incident_roles",
"attributes": {
"name": "<string>",
"summary": "<string>",
"description": "<string>",
"position": 123,
"optional": true,
"enabled": true,
"allow_multi_user_assignment": true
}
}
}
'{
"data": {
"id": "be449fb9-af49-43cd-8d73-63a2e8edfaee",
"type": "incident_roles",
"attributes": {
"slug": "my-incident-role",
"name": "My Incident Role",
"summary": "My Incident Role summary",
"description": "My Incident Role description",
"position": 1,
"optional": false,
"enabled": true,
"allow_multi_user_assignment": true,
"created_at": "2025-12-11T11:01:14.577-08:00",
"updated_at": "2025-12-11T11:01:14.577-08:00"
}
}
}Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Show child attributes
incident_roles Show child attributes
The name of the incident role
The summary of the incident role
The description of the incident role
Position of the incident role
incident_role created
Show child attributes
Unique ID of the incident role
incident_roles Show child attributes
The name of the incident role
Date of creation
Date of last update
The slug of the incident role
The summary of the incident role
The description of the incident role
Position of the incident role
Was this page helpful?
curl --request POST \
--url https://api.rootly.com/v1/incident_roles \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/vnd.api+json' \
--data '
{
"data": {
"type": "incident_roles",
"attributes": {
"name": "<string>",
"summary": "<string>",
"description": "<string>",
"position": 123,
"optional": true,
"enabled": true,
"allow_multi_user_assignment": true
}
}
}
'{
"data": {
"id": "be449fb9-af49-43cd-8d73-63a2e8edfaee",
"type": "incident_roles",
"attributes": {
"slug": "my-incident-role",
"name": "My Incident Role",
"summary": "My Incident Role summary",
"description": "My Incident Role description",
"position": 1,
"optional": false,
"enabled": true,
"allow_multi_user_assignment": true,
"created_at": "2025-12-11T11:01:14.577-08:00",
"updated_at": "2025-12-11T11:01:14.577-08:00"
}
}
}