Skip to main content
PATCH
Update

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string
required

Timeline item to edit

Example:

"01FCNDV6P870EA6S7TK1DSYD5H"

Body

application/json
description
string

Description of the timeline item, in markdown. Send an empty string to remove it.

Example:

"Rolled back **payments-api** to v411 after error rate hit 12%."

timestamp
string<date-time>

When the thing this item describes happened. Only editable on a custom item.

Example:

"2026-09-01T15:30:00Z"

title
string

Title of the timeline item

Minimum string length: 1
Example:

"Rolled back payments-api"

Response

OK response.

incident_timeline_item
object
required

An item on an incident's curated timeline.

The timeline is the narrative of an incident, as opposed to the activity log, which records everything that happened. Some of that activity - a pinned message, an escalation, an event a workflow added - is promoted onto the timeline, and those items carry the ID of the activity log entry they came from. The rest are custom, written by hand in the dashboard or through the API, and have no activity_log_id.