Agent Health

List Agent Health issues

Changed on

List Agent Health issues across your organization. Only open issues are returned. Returns 403 if you lack the hosts_read permission.

Results use a stable order: severity rank (high, medium, low, then other values), then first_seen_at descending with missing timestamps last, then issue ID ascending. Use page[size] and the zero-based page[number] to paginate. Invalid page values return a 400 JSON:API error response. meta.page.total_filtered_count is the number of issues matching the filters, and meta.page.total_count the number of open issues in the organization.

Each filter accepts up to 50 comma-separated exact values of at most 256 characters each, combined with OR within a filter and AND across filters. Blank entries are ignored; an all-blank filter is treated as absent.

get/api/v2/agenthealth/issues

Request

  • Base URL
    https://api.datadoghq.com
  • 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
      Scopeshosts_read

Query parameters

page[size]integer

The number of issues to return per page, from 1 to 100. Defaults to 25.

page[number]integer

The zero-based page number, from 0 to 1000000. Defaults to 0.

filter[severity]string

Filter by a comma-separated list of exact severity values, up to 50 values of at most 256 characters each. Values are combined with OR within this filter and AND across filters. Blank entries are ignored; an all-blank filter is treated as absent.

filter[category]string

Filter by a comma-separated list of exact category values, up to 50 values of at most 256 characters each. Values are combined with OR within this filter and AND across filters. Blank entries are ignored; an all-blank filter is treated as absent.

filter[issue_type]string

Filter by a comma-separated list of exact issue_type values, up to 50 values of at most 256 characters each. Values are combined with OR within this filter and AND across filters. Blank entries are ignored; an all-blank filter is treated as absent.

filter[resource_kind]string

Filter by a comma-separated list of exact resource_kind values, up to 50 values of at most 256 characters each. Values are combined with OR within this filter and AND across filters. Blank entries are ignored; an all-blank filter is treated as absent.

filter[resource_id]string

Filter by a comma-separated list of exact resource_id values, up to 50 values of at most 256 characters each. Values are combined with OR within this filter and AND across filters. Blank entries are ignored; an all-blank filter is treated as absent.

Response

OK

Example response

{
  "data": [
    {
      "attributes": {
        "category": "configuration",
        "description": "The Agent configuration file contains an invalid value.",
        "first_seen_at": "2026-11-01T10:00:00Z",
        "issue_name": "Invalid Config",
        "issue_type": "invalid_config",
        "resource_id": "my-hostname",
        "resource_kind": "host",
        "resource_type": "host",
        "severity": "high",
        "state": "open",
        "tags": [
          "env:prod"
        ],
        "title": "Invalid Agent configuration",
        "updated_at": "2026-11-09T08:00:00Z"
      },
      "id": "invalid-config:4828e7d6c704c4a3",
      "type": "agent_health_issues"
    }
  ],
  "meta": {
    "page": {
      "total_count": 3,
      "total_filtered_count": 1
    }
  }
}

Changes