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

Update an Incident Review

Update the Incident Review for the specified Incident.

This is a partial update: an omitted field leaves the current value unchanged.

Moving status to completed is rejected with 409 while any required section is still unfilled.

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 updated title of the Incident Review.

Length1 <= length <= 255

status?string

The updated status of the Incident Review.

Value in

"started"
"completed"

Response Body

`application/json`

curl -X PUT "https://api.pagerduty.com/incidents/{id}/review" \  -H "Accept: application/vnd.pagerduty+json;version=2" \  -H "Content-Type: application/json" \  -d '{    "title": "Database outage review",    "status": "completed"  }'

{  "incident_review": {    "id": "AGOBAMKTT5Z3RO7CR7T2ZGSMJA",    "incident_id": "P1234ABC",    "title": "Database outage review",    "status": "completed",    "sections": [      {        "title": "Summary",        "content": "{\"type\":\"doc\",\"content\":[]}",        "priority": 0,        "required": true,        "completed_at": "2026-09-02T14:30:00Z"      }    ],    "generation_status": "idle",    "ai_generated": false,    "template_id": "AGOBAMKTT5Z3RO7CR7T2ZGSMJA",    "has_events": true,    "action_item_count": 5,    "completed_action_item_count": 5,    "created_by": "PUSER123",    "created_at": "2026-09-01T20:00:00Z",    "updated_at": "2026-09-02T14:30:00Z",    "completed_at": "2026-09-02T14:30:00Z"  }}

Update an Incident Review

Authorization

Path Parameters

Header Parameters

Request Body

Response Body

200application/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`