View Source IncidentIo.IncidentRolesV2 (IncidentIo v0.1.0-dev)

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.

Summary

Functions

Create a new incident role.

Removes an existing incident role.

List all incident roles for an organisation.

Get a single incident role.

Update an existing incident role.

Functions

Link to this function

create(client \\ %Client{}, body)

View Source
@spec create(IncidentIo.Client.t(), request_body()) :: IncidentIo.response()

Create a new incident role.

Incident role body example:

%{
  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"
}

Example

IncidentIo.IncidentRolesV2.create(client, body)

More information at: https://api-docs.incident.io/tag/Incident-Roles-V2#operation/Incident-Roles%20V2_Create

Link to this function

destroy(client \\ %Client{}, id)

View Source

Removes an existing incident role.

Example

IncidentIo.IncidentRolesV2.destroy(client, "some-incident-role-id")

More information at: https://api-docs.incident.io/tag/Incident-Roles-V2#operation/Incident-Roles%20V2_Delete

Link to this function

list(client \\ %Client{})

View Source

List all incident roles for an organisation.

Example

IncidentIo.IncidentRolesV2.list(client, "some-incident-id")

More information at: https://api-docs.incident.io/tag/Incident-Roles-V2#operation/Incident-Roles%20V2_List

Link to this function

show(client \\ %Client{}, id)

View Source

Get a single incident role.

Example

IncidentIo.IncidentRolesV2.show(client, "some-incident-role-id")

More information at: https://api-docs.incident.io/tag/Incident-Roles-V2#operation/Incident-Roles%20V2_Show

Link to this function

update(client \\ %Client{}, id, body)

View Source
@spec update(IncidentIo.Client.t(), binary(), request_body()) :: IncidentIo.response()

Update an existing incident role.

Incident role body example:

%{
  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"
}

Example

IncidentIo.IncidentRolesV2.update(client, "some-incident-id", body)

More information at: https://api-docs.incident.io/tag/Incident-Roles-V2#operation/Incident-Roles%20V2_Update