For AI agents and assistants: visit https://docs.pagerduty.com/llms.txt for the index.

Add a marker to an Incident Review timeline

Add a marker to the timeline of the Incident Review for the specified Incident.

A marker highlights a point of interest on the timeline. Each entry in notes is added as its own event attached to the new marker.

Returns 404 when the Incident has no Incident Review.

Scoped OAuth requires: incident_reviews.write

Authorization

api_key

Authorization<token>

The API Key with format Token token=<API_KEY>

In: header

Path Parameters

id*string

The ID of the resource.

Header Parameters

Accept*string

The Accept header is used as a versioning header.

Default"application/vnd.pagerduty+json;version=2"

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

title*string

The title of the marker.

Lengthlength <= 255

type?string

The name of an existing marker type. Defaults to Key Moment if omitted.

notes*array<>

One or more notes to attach to the marker as supporting evidence. Each note becomes its own event on the marker.

Items1 <= items

Response Body

`application/json`

curl -X POST "https://api.pagerduty.com/incidents/{id}/review/markers" \  -H "Accept: application/vnd.pagerduty+json;version=2" \  -H "Content-Type: application/json" \  -d '{    "title": "Customer-reported timeline update",    "type": "Key Moment",    "notes": [      "Customer confirmed impact started at 10:42 UTC"    ]  }'

{  "marker": {    "id": "AGOBAMKTT5Z3RO7CR7T2ZGSMJA",    "incident_review_id": "AGOBAMKTT5Z3RO7CR7T2ZGSMJA",    "type": "Key Moment",    "title": "Customer-reported timeline update",    "events": [      {        "id": "AGOBAMKTT5Z3RO7CR7T2ZGSMJB",        "body": "Customer confirmed impact started at 10:42 UTC",        "created_at": "2026-09-01T20:00:00Z"      }    ],    "created_at": "2026-09-01T20:00:00Z"  }}

Add a marker to an Incident Review timeline

Authorization

Path Parameters

Header Parameters

Request Body

Response Body

201application/json

400application/json

401application/json

403application/json

404application/json

429application/json

Developer Agreement

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`