# Incident.io Incident Timeline Items V2 API

**Canonical:** https://apis.io/apis/incident-io/incident-io-incident-timeline-items-v2-api/  
**Provider:** Incident.io — https://apis.io/providers/incident-io/  
**Base URL:** https://api.incident.io  
**Documentation:** https://incident.io

Incident.io Incident Timeline Items V2 API is one of 92 APIs that [Incident.io](https://apis.io/providers/incident-io/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Incident Timeline Items V2. The published artifact set on APIs.io includes an OpenAPI specification.

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.

## Operations (3)

| Method | Path | Summary |
|---|---|---|
| GET | `/v2/incident_timeline_items` | List Incident Timeline Items V2 |
| POST | `/v2/incident_timeline_items` | Create Incident Timeline Items V2 |
| PATCH | `/v2/incident_timeline_items/{id}` | Update Incident Timeline Items V2 |

## Machine-readable artifacts (1)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/incident-io/refs/heads/main/openapi/incident-io-incident-timeline-items-v2-api-openapi.yml

## Other Incident.io APIs (12)

- [Incident.io Actions API](https://apis.io/apis/incident-io/incident-io-actions-api/)
- [Incident.io Alert Attributes API](https://apis.io/apis/incident-io/incident-io-alert-attributes-api/)
- [Incident.io Alert Routes API](https://apis.io/apis/incident-io/incident-io-alert-routes-api/)
- [Incident.io Alert Sources API](https://apis.io/apis/incident-io/incident-io-alert-sources-api/)
- [Incident.io Alerts API](https://apis.io/apis/incident-io/incident-io-alerts-api/)
- [Incident.io API Keys API](https://apis.io/apis/incident-io/incident-io-api-keys-api/)
- [Incident.io Catalog Entries API](https://apis.io/apis/incident-io/incident-io-catalog-entries-api/)
- [Incident.io Catalog Types API](https://apis.io/apis/incident-io/incident-io-catalog-types-api/)
- [Incident.io Custom Fields API](https://apis.io/apis/incident-io/incident-io-custom-fields-api/)
- [Incident.io Escalation Paths API](https://apis.io/apis/incident-io/incident-io-escalation-paths-api/)
- [Incident.io Escalations API](https://apis.io/apis/incident-io/incident-io-escalations-api/)
- [Incident.io Follow-ups API](https://apis.io/apis/incident-io/incident-io-follow-ups-api/)

## Tags

Incident Timeline Items V2

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/incident-io/incident-io-incident-timeline-items-v2-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/incident-io/.