Agent Health

Get an Agent Health issue

Changed on

Get 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 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

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