Agent Health
Get an Agent Health issue
Changed onGet an Agent Health issue and its available remediation in your organization. Only open issues are returned. The remediation attribute is omitted when the issue has no remediation.
Returns 404 if the issue does not exist, is not open, belongs to another organization, or you do not have access to its data. This response does not reveal whether the issue exists. Returns 403 if you lack the hosts_read permission.
get/api/v2/agenthealth/issues/{issue_id}
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
Path parameters
issue_idstring required
The unique identifier of the issue. It can contain : and must be percent-encoded by clients when included in the path.
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",
"remediation": {
"script": {
"content": "...",
"filename": "fix.sh",
"language": "bash",
"language_version": "5",
"requires_root": true
},
"steps": [
{
"order": 1,
"text": "Open datadog.yaml"
}
],
"summary": "Fix the invalid configuration value."
},
"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"
}
}Changes
- info
endpoint added
- info