v1

latestOpenAPI 3.0.02026-07-141,4077,1665.2 MB

Incidents

Create postmortem attachment

Create a postmortem attachment for an incident.

The endpoint accepts markdown for notebooks created in Confluence or Google Docs. Postmortems created from notebooks need to be formatted using frontend notebook cells, in addition to markdown format.

post/api/v2/incidents/{incident_id}/attachments/postmortems

Path parameters

incident_idstring required

Example:00000000-0000-0000-0000-000000000000

The ID of the incident

Request body

Example request

{
  "data": {
    "attributes": {
      "cells": [
        {
          "attributes": {
            "definition": {
              "content": "## Incident Summary\nThis incident was caused by..."
            }
          },
          "id": "cell-1",
          "type": "markdown"
        }
      ],
      "content": "# Incident Report - IR-123\n[...]",
      "postmortem_template_id": "93645509-874e-45c4-adfa-623bfeaead89-123",
      "title": "Postmortem-IR-123"
    },
    "type": "incident_attachments"
  }
}

Response

Created

Example response

{
  "data": {
    "attributes": {
      "attachment": {
        "documentUrl": "https://app.datadoghq.com/notebook/123/Postmortem-IR-123",
        "title": "Postmortem IR-123"
      },
      "attachment_type": "postmortem",
      "modified": "2025-01-01T01:01:01.000000001Z"
    },
    "id": "00000000-abcd-0002-0000-000000000000",
    "relationships": {
      "incident": {
        "data": {
          "id": "00000000-0000-0000-1234-000000000000",
          "type": "incidents"
        }
      },
      "last_modified_by_user": {
        "data": {
          "id": "00000000-0000-0000-2345-000000000000",
          "type": "users"
        }
      }
    },
    "type": "incident_attachments"
  },
  "included": [
    {
      "type": "users"
    }
  ]
}