Skip to content

Create an Incident Update Template

Request

Creates a new template. Template don't have to contain values set for all possible fields. If there is no value present for one of the field, during applying the template such field will be ignored.

Security
ApiKeyAuth
Path
subdomainstringrequired

Unique subdomain of requested Hub.

Query
api_versionstring

Api version

Value:"V3-R1"
Bodyapplication/json
titlestring or null

Title of event. Can be omitted if body is provided.

Can contain only plain text. HTML tags and other forms of formatting are not allowed.
Templates without title set will ignore event title when applied.

bodystring or null

Title of event. Can be omitted if title is provided.

Can contain basic HTML tags and is being interpreted as HTML.
Templates without body set will ignore event body when applied.

incident_typestring or null
Enum:"investigating""identified""monitoring""resolved"
labelsArray of strings

List of labels for this template. Template can have many labels.
If passing just one label, it should still be passed as an array: "labels": ["some label value"].

service_statusesArray of objects

Describes affected services and their statuses.

silent_updateboolean or null

Controls silent parameter value when applying the template:

  • true - Set event silent parameter as true,
  • false - Set event silent parameter as false,
  • null - Do not set event silent parameter.
curl -i -X POST \
  'https://subdomain-of-your-account.app.statushub.io/api/v3/hubs/{subdomain}/incident_templates?api_version=V3-R1' \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE' \
  -d '{
    "title": "string",
    "body": "string",
    "incident_type": "investigating",
    "labels": [
      "string"
    ],
    "service_statuses": [
      {
        "service_id": 1234,
        "status": "down"
      }
    ],
    "silent_update": true
  }'

Responses

OK

Bodyapplication/json
idinteger, >= 1
Example:38
titlestring or null

Title of event.
Templates without title set will ignore event title when applied.

labelsArray of strings

List of labels for this template.

flagsobject
incident_typestring or null
Enum:"investigating""identified""monitoring""resolved"
bodystring or null

Title of event.
Templates without body set will ignore event body when applied.

created_atstring, (date-time)

Timestamp of record creation.
ISO8601 formatted time (UTC).

Example:"2020-09-01T08:29:00Z"
updated_atstring, (date-time)

Timestamp of last modification of record.
ISO8601 formatted time (UTC).

Example:"2020-09-01T08:29:00Z"
authorstring or null

Author email

service_statusesArray of objects
Response
{
  "id": 38,
  "title": "string",
  "labels": [
    "string"
  ],
  "flags": {
    "deleted": true,
    "silent": true
  },
  "incident_type": "investigating",
  "body": "string",
  "created_at": "2020-09-01T08:29:00Z",
  "updated_at": "2020-09-01T08:29:00Z",
  "author": "string",
  "service_statuses": [
    { … }
  ]
}