Skip to main content
POST
Create

Authorizations

Authorization
string
header
required

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

Body

application/json
idempotency_key
string
required

Unique string used to de-duplicate timeline item requests. Retrying with the same key returns the item the first request created, rather than adding a second one.

Minimum string length: 1
Example:

"deploy-4f2c1b90"

incident_id
string
required

Incident to add this item to

Example:

"01FCNDV6P870EA6S7TK1DSYD5H"

timestamp
string<date-time>
required

When the thing this item describes happened. This is where the item sits on the timeline, and can be in the past.

Example:

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

title
string
required

Title of the timeline item

Minimum string length: 1
Example:

"Rolled back payments-api"

description
string

Description of the timeline item, in markdown

Example:

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

Response

Created 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.