ListIncidents

Get all incidents for the user's organization.

Query Parameters:

include: Specifies which types of related objects should be included in the response.
page[size]: Size for a given page. The maximum allowed value is 100.
page[offset]: Specific offset to use as the beginning of the returned page.

Responses:

200 (Success): OK
- Content-Type: application/json
- Response Properties:
  - data: An array of incidents.
  - included: Included related resources that the user requested.
- Example:

{
  "data": [
    {
      "attributes": {
        "created": "2020-04-21T15:34:08.627205+00:00",
        "creation_idempotency_key": null,
        "customer_impact_duration": 0,
        "customer_impact_end": null,
        "customer_impact_scope": null,
        "customer_impact_start": null,
        "customer_impacted": false,
        "detected": "2020-04-14T00:00:00+00:00",
        "incident_type_uuid": "00000000-0000-0000-0000-000000000001",
        "modified": "2020-09-17T14:16:58.696424+00:00",
        "public_id": 1,
        "resolved": null,
        "severity": "SEV-1",
        "time_to_detect": 0,
        "time_to_internal_response": 0,
        "time_to_repair": 0,
        "time_to_resolve": 0,
        "title": "Example Incident"
      },
      "id": "00000000-aaaa-0000-0000-000000000000",
      "relationships": {
        "attachments": {
          "data": [
            {
              "id": "00000000-9999-0000-0000-000000000000",
              "type": "incident_attachments"
            },
            {
              "id": "00000000-1234-0000-0000-000000000000",
              "type": "incident_attachments"
            }
          ]
        },
        "commander_user": {
          "data": {
            "id": "00000000-0000-0000-cccc-000000000000",
            "type": "users"
          }
        },
        "created_by_user": {
          "data": {
            "id": "00000000-0000-0000-cccc-000000000000",
            "type": "users"
          }
        },
        "integrations": {
          "data": [
            {
              "id": "00000000-0000-0000-4444-000000000000",
              "type": "incident_integrations"
            },
            {
              "id": "00000000-0000-0000-5555-000000000000",
              "type": "incident_integrations"
            }
          ]
        },
        "last_modified_by_user": {
          "data": {
            "id": "00000000-0000-0000-cccc-000000000000",
            "type": "users"
          }
        }
      },
      "type": "incidents"
    },
    {
      "attributes": {
        "created": "2020-04-21T15:34:08.627205+00:00",
        "creation_idempotency_key": null,
        "customer_impact_duration": 0,
        "customer_impact_end": null,
        "customer_impact_scope": null,
        "customer_impact_start": null,
        "customer_impacted": false,
        "detected": "2020-04-14T00:00:00+00:00",
        "incident_type_uuid": "00000000-0000-0000-0000-000000000002",
        "modified": "2020-09-17T14:16:58.696424+00:00",
        "public_id": 2,
        "resolved": null,
        "severity": "SEV-5",
        "time_to_detect": 0,
        "time_to_internal_response": 0,
        "time_to_repair": 0,
        "time_to_resolve": 0,
        "title": "Example Incident 2"
      },
      "id": "00000000-1111-0000-0000-000000000000",
      "relationships": {
        "attachments": {
          "data": [
            {
              "id": "00000000-9999-0000-0000-000000000000",
              "type": "incident_attachments"
            }
          ]
        },
        "commander_user": {
          "data": {
            "id": "00000000-aaaa-0000-0000-000000000000",
            "type": "users"
          }
        },
        "created_by_user": {
          "data": {
            "id": "00000000-aaaa-0000-0000-000000000000",
            "type": "users"
          }
        },
        "integrations": {
          "data": [
            {
              "id": "00000000-0000-0000-0001-000000000000",
              "type": "incident_integrations"
            },
            {
              "id": "00000000-0000-0000-0002-000000000000",
              "type": "incident_integrations"
            }
          ]
        },
        "last_modified_by_user": {
          "data": {
            "id": "00000000-aaaa-0000-0000-000000000000",
            "type": "users"
          }
        }
      },
      "type": "incidents"
    }
  ],
  "included": [
    "unknown_type"
  ],
  "meta": "unknown_type"
}

400: Bad Request
- Content-Type: application/json
- Response Properties:
  - errors: A list of errors.
- Example:

{
  "errors": [
    "Bad Request"
  ]
}

401: Unauthorized
- Content-Type: application/json
- Response Properties:
  - errors: A list of errors.
- Example:

{
  "errors": [
    "Bad Request"
  ]
}

403: Forbidden
- Content-Type: application/json
- Response Properties:
  - errors: A list of errors.
- Example:

{
  "errors": [
    "Bad Request"
  ]
}

404: Not Found
- Content-Type: application/json
- Response Properties:
  - errors: A list of errors.
- Example:

{
  "errors": [
    "Bad Request"
  ]
}

429: Too many requests
- Content-Type: application/json
- Response Properties:
  - errors: A list of errors.
- Example:

{
  "errors": [
    "Bad Request"
  ]
}

Name	Required	Description
`include`	No	Specifies which types of related objects should be included in the response.
`page[offset]`	No	Specific offset to use as the beginning of the returned page.
`page[size]`	No	Size for a given page. The maximum allowed value is 100.

{
  "$defs": {
    "IncidentRelatedObject": {
      "description": "Object related to an incident.",
      "enum": [
        "users",
        "attachments"
      ],
      "type": "string",
      "x-enum-varnames": [
        "USERS",
        "ATTACHMENTS"
      ]
    }
  },
  "properties": {
    "include": {
      "description": "Specifies which types of related objects should be included in the response.",
      "items": {
        "$ref": "#/$defs/IncidentRelatedObject"
      },
      "type": "array"
    },
    "page[offset]": {
      "default": 0,
      "description": "Specific offset to use as the beginning of the returned page.",
      "example": 0,
      "format": "int64",
      "type": "integer"
    },
    "page[size]": {
      "default": 10,
      "description": "Size for a given page. The maximum allowed value is 100.",
      "example": 10,
      "format": "int64",
      "type": "integer"
    }
  },
  "required": [],
  "type": "object"
}

Datadog MCP Server

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Datadog MCP Server

Related Tools

MCP directory API