Skip to main content
PUT
/
v1
/
post_mortems
/
{id}
Update an incident retrospective
curl --request PUT \
  --url https://api.rootly.com/v1/post_mortems/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/vnd.api+json' \
  --data '{
  "data": {
    "type": "incident_post_mortems",
    "attributes": {
      "title": "<string>",
      "status": "draft",
      "started_at": "<string>",
      "mitigated_at": "<string>",
      "resolved_at": "<string>",
      "show_timeline": true,
      "show_timeline_trail": true,
      "show_timeline_genius": true,
      "show_timeline_tasks": true,
      "show_timeline_action_items": true,
      "show_services_impacted": true,
      "show_functionalities_impacted": true,
      "show_groups_impacted": true,
      "show_alerts_attached": true,
      "show_action_items": true,
      "cause_ids": [
        "<string>"
      ]
    }
  }
}'
{
  "data": {
    "id": "4eaf806b-6b90-44f6-9e1f-9b0b3eb69a62",
    "type": "incident_post_mortems",
    "attributes": {
      "incident_id": "c8f71058-0500-41d1-b940-f2aaf62ac9b5",
      "title": "Retrospective updated",
      "status": "draft",
      "url": "https://test.rootly.com/account/post_mortems/architecto-et-est-soluta",
      "short_url": null,
      "content": null,
      "published_at": null,
      "started_at": "2025-10-11T04:24:54.819-07:00",
      "mitigated_at": null,
      "resolved_at": null,
      "cancelled_at": null,
      "show_timeline": false,
      "show_timeline_starred_only": false,
      "show_timeline_genius": true,
      "show_timeline_trail": true,
      "show_timeline_tasks": true,
      "show_timeline_action_items": true,
      "show_timeline_order": "desc",
      "show_functionalities_impacted": true,
      "show_services_impacted": true,
      "show_groups_impacted": true,
      "show_action_items": true,
      "created_at": "2025-10-11T04:24:55.401-07:00",
      "updated_at": "2025-10-11T04:25:05.477-07:00"
    },
    "relationships": {
      "incident_retrospective_steps": {
        "data": []
      }
    }
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
required

Resource UUID

Body

application/vnd.api+json
data
object
required

Response

incident_post_mortem updated

data
object
required
I