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

Add a marker to a Post-Incident Review timeline

Add a marker to the timeline of the Post-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 Post-Incident Review, or if the caller cannot see it, and 409 when the Post-Incident Review is completed and must be reopened first.

409 is also returned if the Post-Incident Review is locked, or if it uses a format this version of the API cannot edit.

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 a Post-Incident Review timeline

Authorization

Path Parameters

Header Parameters

Request Body

Response Body

201application/json

400application/json

401application/json

403application/json

404application/json

409application/json

429application/json

Developer Agreement

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`