> ## Documentation Index
> Fetch the complete documentation index at: https://docs.incident.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Incident Timeline Items

> API endpoints for incident timeline items

Read and write the items on an incident's timeline.

The timeline is the curated narrative of an incident: the handful of moments that explain what
happened, rather than the activity log, which records everything that did. Items are either
promoted or custom. Promoted items are activity lifted onto the timeline - a pinned message,
an escalation, an incident update, an event added by a workflow - and carry the ID of the
activity log entry they came from. Custom items are written by hand, in the dashboard or
through this API, and have no activity\_log\_id.

Use this to pull an incident's narrative into your own systems - a retrospective template, a
report, a record you keep outside incident.io - and to put the things you know about back on
it, like a deploy, a config change or a load test you halted.

## The incident timeline item object