Incident Timeline Items
API endpoints for incident timeline items
The incident timeline item object
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.
When this item was added to the timeline
"2026-09-01T15:31:04Z"
Show child attributes
Show child attributes
{
"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"
}
}
Unique identifier of the timeline item
"01FCNDV6P870EA6S7TK1DSYDG0"
ID of the incident this item belongs to. When the incident has streams, listing the parent also returns items belonging to its streams, and this is the stream's ID for those.
"01G0J1EXE7AXZ2C93K61WBPYEH"
When the thing this item describes happened. This is what the timeline is ordered by, and is not the same as created_at.
"2026-09-01T15:30:00Z"
Title of the timeline item
"Rolled back payments-api"
When this item was last edited
"2026-09-01T16:45:00Z"
ID of the activity log entry this item was promoted from. Null for items written by hand, which are the items whose timestamp can be changed.
"01FCNDV6P870EA6S7TK1DSYDG1"
Description of the timeline item, in markdown. Absent when the item has no description.
"Rolled back **payments-api** to v411 after error rate hit 12%."
Was this page helpful?
{
"created_at": "2026-09-01T15:31:04Z",
"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": "01G0J1EXE7AXZ2C93K61WBPYEH",
"timestamp": "2026-09-01T15:30:00Z",
"title": "Rolled back payments-api",
"updated_at": "2026-09-01T16:45:00Z",
"activity_log_id": "01FCNDV6P870EA6S7TK1DSYDG1",
"description": "Rolled back **payments-api** to v411 after error rate hit 12%."
}