Skip to main content
PUT
Update
🔑 Requires the follow_ups.update scope.

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string
required

Unique identifier for the follow-up

Example:

"01FCNDV6P870EA6S7TK1DSYDG0"

Body

application/json
status
enum<string>
required

Status of the follow-up. Setting this to deleted is not allowed; use the delete endpoint instead.

Available options:
outstanding,
completed,
deleted,
not_doing
Example:

"outstanding"

title
string
required

Title of the follow-up

Example:

"Add alerting on replica lag"

assignee_id
string

ID of the user this follow-up is assigned to. Set to null to unassign.

Example:

"01FCNDV6P870EA6S7TK1DSYDG0"

assignee_team_id
string

ID of the team this follow-up is assigned to. Set to null to unassign.

Example:

"01FCNDV6P870EA6S7TK1DSYDG0"

description
string

Description of the follow-up. Supports Markdown.

Example:

"Call the fire brigade"

follow_up_category_id
string

ID of the category for this follow-up

Example:

"01GNW4BAQ7XRMFF6FHKNXDFPRW"

follow_up_priority_option_id
string

ID of the priority for this follow-up

Example:

"01GNW4BAQ7XRMFF6FHKNXDFPRW"

labels
string[]

Labels associated with this follow-up

Example:

Response

200 - application/json

OK response.

follow_up
object
required