{
  "opencollection": "1.0.0",
  "info": {
    "name": "Datadog Incidents API",
    "version": "v2"
  },
  "request": {
    "auth": {
      "type": "apikey",
      "key": "DD-API-KEY",
      "value": "{{DD-API-KEY}}",
      "placement": "header"
    }
  },
  "items": [
    {
      "info": {
        "name": "Incidents",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Datadog List Incidents",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.datadoghq.com/api/v2/incidents",
            "params": [
              {
                "name": "include",
                "value": "example_value",
                "type": "query",
                "description": "Comma-separated list of related resources to include (e.g., attachments, responders, commander)"
              },
              {
                "name": "page[size]",
                "value": "42",
                "type": "query",
                "description": "The number of incidents to return per page (default 10, max 100)"
              },
              {
                "name": "page[offset]",
                "value": "42",
                "type": "query",
                "description": "The offset for pagination (number of records to skip)"
              },
              {
                "name": "filter[state]",
                "value": "active",
                "type": "query",
                "description": "Filter incidents by their current state"
              },
              {
                "name": "filter[severity]",
                "value": "example_value",
                "type": "query",
                "description": "Filter incidents by severity level (SEV-1 to SEV-5)"
              }
            ]
          },
          "docs": "Returns a paginated list of incidents for your Datadog organization. Results can be filtered by incident state, severity, and date range. Supports including related resources such as users, teams, services, and attachments. Incidents are returned in reverse chronological order by default. Use cursor-based pagination for large datasets."
        },
        {
          "info": {
            "name": "Datadog Create an Incident",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.datadoghq.com/api/v2/incidents",
            "params": [
              {
                "name": "include",
                "value": "example_value",
                "type": "query",
                "description": "Comma-separated list of related resources to include in the response (e.g., attachments, responders)"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Creates a new incident record in Datadog Incident Management. An incident captures an outage or issue, including its title, severity, status, customer impact description, and associated fields. Creating an incident triggers notifications to configured responders and creates a dedicated Slack channel if configured. The incident is assigned a unique ID and timestamped at creation time. Custom fields configured in your organization settings can be set on incident creation."
        },
        {
          "info": {
            "name": "Datadog Get the Details of an Incident",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.datadoghq.com/api/v2/incidents/:incident_id",
            "params": [
              {
                "name": "incident_id",
                "value": "",
                "type": "path",
                "description": "The unique string identifier of the incident"
              },
              {
                "name": "include",
                "value": "example_value",
                "type": "query",
                "description": "Comma-separated list of related resources to include in the response"
              }
            ]
          },
          "docs": "Returns the full details of a specific incident identified by its unique ID. Includes the incident title, status, severity, customer impact description, timeline, custom fields, and optionally associated responders, services, teams, and attachments. Use the include parameter to fetch related resources in a single request."
        },
        {
          "info": {
            "name": "Datadog Update an Existing Incident",
            "type": "http"
          },
          "http": {
            "method": "PATCH",
            "url": "https://api.datadoghq.com/api/v2/incidents/:incident_id",
            "params": [
              {
                "name": "incident_id",
                "value": "",
                "type": "path",
                "description": "The unique string identifier of the incident"
              },
              {
                "name": "include",
                "value": "example_value",
                "type": "query",
                "description": "Comma-separated list of related resources to include in the response"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Updates an existing incident with new information. Supports partial updates using JSON merge patch semantics. Can update the incident title, status, severity, customer impact fields, custom fields, and notification handles. Status transitions trigger automatic timeline entries and notifications to responders. Resolving an incident records the resolution time and optionally captures customer impact duration."
        },
        {
          "info": {
            "name": "Datadog Delete an Existing Incident",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://api.datadoghq.com/api/v2/incidents/:incident_id",
            "params": [
              {
                "name": "incident_id",
                "value": "",
                "type": "path",
                "description": "The unique string identifier of the incident"
              }
            ]
          },
          "docs": "Permanently deletes the incident with the specified ID. This action cannot be undone. Deleting an incident removes all associated timeline events, attachments, and todos. Associated Slack channels are not automatically archived. Only users with the Incident Management write permission can delete incidents."
        }
      ]
    },
    {
      "info": {
        "name": "Incident Teams",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Datadog Get a List of Incident Teams",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.datadoghq.com/api/v2/teams",
            "params": [
              {
                "name": "filter[query]",
                "value": "avg:system.cpu.user{*}",
                "type": "query",
                "description": "Filter teams by name using a substring search"
              },
              {
                "name": "page[size]",
                "value": "42",
                "type": "query",
                "description": "The number of teams to return per page"
              },
              {
                "name": "page[offset]",
                "value": "42",
                "type": "query",
                "description": "The number of records to skip for pagination"
              }
            ]
          },
          "docs": "Returns a paginated list of all incident teams configured in your Datadog organization. Teams can be filtered by name. Incident teams are used to organize responders and route incidents to appropriate groups. Returns team names and IDs for use when associating teams with incidents."
        },
        {
          "info": {
            "name": "Datadog Create a New Incident Team",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.datadoghq.com/api/v2/teams",
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Creates a new incident team that can be associated with incidents for organizing responders. Teams help route incidents to the appropriate on-call groups and provide a way to track ownership and responsibility during incident response. Teams can be referenced when creating or updating incidents."
        },
        {
          "info": {
            "name": "Datadog Get Details of an Incident Team",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.datadoghq.com/api/v2/teams/:team_id",
            "params": [
              {
                "name": "team_id",
                "value": "",
                "type": "path",
                "description": "The unique string identifier of the incident team"
              }
            ]
          },
          "docs": "Returns the full details of a specific incident team identified by its unique ID, including the team name, creation time, and optional included resources such as team members."
        },
        {
          "info": {
            "name": "Datadog Update an Existing Incident Team",
            "type": "http"
          },
          "http": {
            "method": "PATCH",
            "url": "https://api.datadoghq.com/api/v2/teams/:team_id",
            "params": [
              {
                "name": "team_id",
                "value": "",
                "type": "path",
                "description": "The unique string identifier of the incident team"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Updates the name or configuration of an existing incident team. Team membership is managed separately through user management endpoints. Changes take effect immediately for all future incident associations."
        },
        {
          "info": {
            "name": "Datadog Delete an Existing Incident Team",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://api.datadoghq.com/api/v2/teams/:team_id",
            "params": [
              {
                "name": "team_id",
                "value": "",
                "type": "path",
                "description": "The unique string identifier of the incident team"
              }
            ]
          },
          "docs": "Permanently deletes an incident team. The team is disassociated from any incidents that reference it. This action cannot be undone. Incidents that referenced the deleted team will no longer show the team association."
        }
      ]
    }
  ],
  "bundled": true
}