{ "opencollection": "1.0.0", "info": { "name": "Datadog Account Incidents API", "version": "1.0" }, "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://{subdomain}.{site}/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://{subdomain}.{site}/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://{subdomain}.{site}/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://{subdomain}.{site}/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://{subdomain}.{site}/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." } ] } ], "bundled": true }