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": "87da9f6c-be74-4ab1-a4d9-5111cd1f02bf",
    "type": "incident_post_mortems",
    "attributes": {
      "incident_id": "a1e6d0a1-fac0-4ac7-beba-8ab693d71518",
      "title": "Retrospective updated",
      "status": "draft",
      "url": "https://test.rootly.com/account/post_mortems/optio-iusto-consequuntur-dolores",
      "short_url": null,
      "content": null,
      "published_at": null,
      "started_at": "2025-12-17T09:57:33.409-08: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-12-17T09:57:33.893-08:00",
      "updated_at": "2025-12-17T09:57:40.382-08: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