Follow-ups

Manage incident follow-ups. Incidents can have follow-ups associated with them, which track work that should be done after an incident (e.g. improving some documentation, or upgrading a dependency). They can also be exported to external issue trackers. You can manage follow-ups in the incident Slack channel with /incident follow-ups, or on the incident homepage.

The follow-up object

created_at

string<date-time>

required

When the follow-up was created

Example:

"2021-08-17T13:28:57.801578Z"

creator

object

required

Show child attributes

Example:

{
  "alert": {
    "id": "01GW2G3V0S59R238FAHPDS1R66",
    "title": "*errors.withMessage: PG::Error failed to connect"
  },
  "api_key": {
    "id": "01FCNDV6P870EA6S7TK1DSYDG0",
    "name": "My test API key"
  },
  "user": {
    "email": "lisa@incident.io",
    "id": "01FCNDV6P870EA6S7TK1DSYDG0",
    "name": "Lisa Karlin Curtis",
    "role": "owner",
    "slack_user_id": "U02AYNF2XJM"
  },
  "workflow": {
    "id": "01FCNDV6P870EA6S7TK1DSYDG0",
    "name": "My little workflow"
  }
}

string

required

Unique identifier for the follow-up

Example:

"01FCNDV6P870EA6S7TK1DSYDG0"

incident_id

string

required

Unique identifier of the incident the follow-up belongs to

Example:

"01FCNDV6P870EA6S7TK1DSYDG0"

labels

string[]

required

Labels associated with this follow-up

Example:

["bug", "urgent"]

status

enum<string>

required

Status of the follow-up

Available options:

outstanding,

completed,

deleted,

not_doing

Example:

"outstanding"

title

string

required

Title of the follow-up

Example:

"Cat is stuck in the tree"

updated_at

string<date-time>

required

When the follow-up was last updated

Example:

"2021-08-17T13:28:57.801578Z"

assignee

object

Show child attributes

Example:

{
  "email": "lisa@incident.io",
  "id": "01FCNDV6P870EA6S7TK1DSYDG0",
  "name": "Lisa Karlin Curtis",
  "role": "owner",
  "slack_user_id": "U02AYNF2XJM"
}

assignee_team

object

Show child attributes

Example:

{ "id": "abc123", "name": "abc123" }

completed_at

string<date-time>

When the follow-up was completed

Example:

"2021-08-17T13:28:57.801578Z"

description

string

Description of the follow-up

Example:

"Call the fire brigade"

external_issue_reference

object

Show child attributes

Example:

{
  "issue_name": "INC-123",
  "issue_permalink": "https://linear.app/incident-io/issue/INC-1609/find-copywriter-to-write-up",
  "provider": "asana"
}

priority

object

Show child attributes

Example:

{
  "description": "A follow-up that requires immediate attention.",
  "id": "01GNW4BAQ7XRMFF6FHKNXDFPRW",
  "name": "Urgent",
  "rank": 10
}

Cancel

List

⌘I

{
  "created_at": "2021-08-17T13:28:57.801578Z",
  "creator": {
    "alert": {
      "id": "01GW2G3V0S59R238FAHPDS1R66",
      "title": "*errors.withMessage: PG::Error failed to connect"
    },
    "api_key": {
      "id": "01FCNDV6P870EA6S7TK1DSYDG0",
      "name": "My test API key"
    },
    "user": {
      "email": "lisa@incident.io",
      "id": "01FCNDV6P870EA6S7TK1DSYDG0",
      "name": "Lisa Karlin Curtis",
      "role": "owner",
      "slack_user_id": "U02AYNF2XJM"
    },
    "workflow": {
      "id": "01FCNDV6P870EA6S7TK1DSYDG0",
      "name": "My little workflow"
    }
  },
  "id": "01FCNDV6P870EA6S7TK1DSYDG0",
  "incident_id": "01FCNDV6P870EA6S7TK1DSYDG0",
  "labels": [
    "bug",
    "urgent"
  ],
  "status": "outstanding",
  "title": "Cat is stuck in the tree",
  "updated_at": "2021-08-17T13:28:57.801578Z",
  "assignee": {
    "email": "lisa@incident.io",
    "id": "01FCNDV6P870EA6S7TK1DSYDG0",
    "name": "Lisa Karlin Curtis",
    "role": "owner",
    "slack_user_id": "U02AYNF2XJM"
  },
  "assignee_team": {
    "id": "abc123",
    "name": "abc123"
  },
  "completed_at": "2021-08-17T13:28:57.801578Z",
  "description": "Call the fire brigade",
  "external_issue_reference": {
    "issue_name": "INC-123",
    "issue_permalink": "https://linear.app/incident-io/issue/INC-1609/find-copywriter-to-write-up",
    "provider": "asana"
  },
  "priority": {
    "description": "A follow-up that requires immediate attention.",
    "id": "01GNW4BAQ7XRMFF6FHKNXDFPRW",
    "name": "Urgent",
    "rank": 10
  }
}

Getting started

Webhooks

Audit logs

Deprecated endpoints

The follow-up object

​The follow-up object

The follow-up object