List Agent Health issues
Changed onList 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.
Request
- Base URLhttps://api.datadoghq.com
- Auth
- API key in header DD-API-KEY and API key in header DD-APPLICATION-KEY
- or OAuth 2Authorization code/oauth2/v1/authorizeToken URL/oauth2/v1/tokenScopeshosts_read
Query parameters
The number of issues to return per page, from 1 to 100. Defaults to 25.
The zero-based page number, from 0 to 1000000. Defaults to 0.
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 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 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 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 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
- info
endpoint added
- info