---
title: "Update Incident Roles V2"
method: PUT
path: "/v2/incident_roles/{id}"
tags: ["Incident Roles V2"]
---

# Update Incident Roles V2

`PUT /v2/incident_roles/{id}`

Update an existing incident role

## Path parameters

- `id` string, required

## Request body

- IncidentRolesV2UpdateRequestBody
  - `description` string, required — Describes the purpose of the role
  - `instructions` string, required — Provided to whoever is nominated for the role. Note that this will be empty for the 'reporter' role.
  - `name` string, required — Human readable name of the incident role
  - `shortform` string, required — Short human readable name for Slack. Note that this will be empty for the 'reporter' role.

## Response `200`

OK response.

- IncidentRolesV2UpdateResponseBody
  - `incident_role` IncidentRoleV2, required
    - `created_at` string, date-time, required — When the role was created
    - `description` string, required — Describes the purpose of the role
    - `id` string, required — Unique identifier for the role
    - `instructions` string, required — Provided to whoever is nominated for the role. Note that this will be empty for the 'reporter' role.
    - `name` string, required — Human readable name of the incident role
    - `role_type` 'lead' | 'reporter' | 'custom', required — Type of incident role
    - `shortform` string, required — Short human readable name for Slack. Note that this will be empty for the 'reporter' role.
    - `updated_at` string, date-time, required — When the role was last updated

---

[API](https://skmtc.net/incident/apis/incident-io.md) · [All operations](https://skmtc.net/incident/apis/incident-io/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/incident/incident-io/revisions/602fc25ddd76/schema)