DAdatadog
Status Pages

Create backfilled degradation

Creates a backfilled degradation with predefined updates.

post/api/v2/statuspages/{page_id}/degradations/backfill

Request

  • Base URL
    https://api.datadoghq.com
  • URL
    https://api.datadoghq.com/api/v2/statuspages/{page_id}/degradations/backfill
  • Auth
    • API key in header DD-API-KEY and API key in header DD-APPLICATION-KEY
    • or OAuth 2
      Authorization code: /oauth2/v1/authorize
      Token URL: /oauth2/v1/token scopes: status_pages_incident_write

Path parameters

page_idstring uuid required

The ID of the status page.

Query parameters

includestring

Comma-separated list of resources to include. Supported values: created_by_user, last_modified_by_user, status_page.

Request body

Example request

{
  "data": {
    "attributes": {
      "title": "Past API Outage",
      "updates": [
        {
          "components_affected": [
            {
              "id": "1234abcd-12ab-34cd-56ef-123456abcdef",
              "status": "degraded"
            }
          ],
          "description": "We detected elevated error rates in the API.",
          "started_at": "2026-04-27T13:37:31.038001628Z",
          "status": "investigating"
        },
        {
          "components_affected": [
            {
              "id": "1234abcd-12ab-34cd-56ef-123456abcdef",
              "status": "degraded"
            }
          ],
          "description": "Root cause identified as a misconfigured deployment.",
          "started_at": "2026-04-27T14:07:31.038001628Z",
          "status": "identified"
        },
        {
          "components_affected": [
            {
              "id": "1234abcd-12ab-34cd-56ef-123456abcdef",
              "status": "operational"
            }
          ],
          "description": "The issue has been resolved and API is operating normally.",
          "started_at": "2026-04-27T14:37:31.038001628Z",
          "status": "resolved"
        }
      ]
    },
    "type": "degradations"
  }
}

Response

Created

Example response

{
  "data": {
    "attributes": {
      "components_affected": [
        {
          "id": "1234abcd-12ab-34cd-56ef-123456abcdef",
          "status": "operational"
        }
      ],
      "source": {
        "type": "incident"
      },
      "status": "investigating",
      "updates": [
        {
          "components_affected": [
            {
              "id": "1234abcd-12ab-34cd-56ef-123456abcdef",
              "status": "operational"
            }
          ],
          "status": "investigating"
        }
      ]
    },
    "relationships": {
      "created_by_user": {
        "data": {
          "type": "users"
        }
      },
      "last_modified_by_user": {
        "data": {
          "type": "users"
        }
      },
      "status_page": {
        "data": {
          "id": "1234abcd-12ab-34cd-56ef-123456abcdef",
          "type": "status_pages"
        }
      }
    },
    "type": "degradations"
  },
  "included": [
    {
      "type": "users"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.