Skip to main content
POST
/
v1
/
severities
Create
curl --request POST \
  --url https://api.incident.io/v1/severities \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "description": "Issues with **low impact**.",
  "name": "Minor",
  "rank": 1
}
'
{
  "severity": {
    "created_at": "2021-08-17T13:28:57.801578Z",
    "description": "Issues with **low impact**.",
    "id": "01FCNDV6P870EA6S7TK1DSYDG0",
    "name": "Minor",
    "rank": 1,
    "updated_at": "2021-08-17T13:28:57.801578Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.incident.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

API key from your incident.io dashboard (Settings → API keys)

Body

application/json
​
description
string
required

Description of the severity

Example:

"Issues with **low impact**."

​
name
string
required

Human readable name of the severity

Maximum string length: 50
Example:

"Minor"

​
rank
integer<int64>

Rank to help sort severities (lower numbers are less severe)

Example:

1

Response

201 - application/json

Created response.

​
severity
object
required