latestSwagger 2.02026-08-102194011.3 MB

602fc25ddd76

Incident Statuses V1

Create Incident Statuses V1

Create a new incident status

post/v1/incident_statuses

Request body

category'live' | 'learning' | 'closed' required

Whether the status should be considered 'live' (now renamed to active), 'learning' (now renamed to post-incident) or 'closed'. The triage and declined statuses cannot be created or modified.

descriptionstring required

Rich text description of the incident status

namestring required

Unique name of this status

Example request

{
  "category": "live",
  "description": "Impact has been **fully mitigated**, and we're ready to learn from this incident.",
  "name": "Closed"
}

Response

Created response.

Example response

{
  "incident_status": {
    "category": "triage",
    "created_at": "2021-08-17T13:28:57.801578Z",
    "description": "Impact has been **fully mitigated**, and we're ready to learn from this incident.",
    "id": "01FCNDV6P870EA6S7TK1DSYD5H",
    "name": "Closed",
    "rank": 4,
    "updated_at": "2021-08-17T13:28:57.801578Z"
  }
}