---
title: "Get an Agent Health issue"
method: GET
path: "/api/v2/agenthealth/issues/{issue_id}"
tags: ["Agent Health"]
---

# Get an Agent Health issue

`GET /api/v2/agenthealth/issues/{issue_id}`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/agenthealth/issues/{issue_id}`
- Auth: one of:
  - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`
  - OAuth 2
    - Authorization code: `/oauth2/v1/authorize`
    - Token URL: `/oauth2/v1/token` scopes: `hosts_read`

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.

## Path parameters

- `issue_id` string, required

## Response `200`

OK

- AgentHealthIssueResponse: A response containing an open Agent Health issue and available remediation.
  - `data` AgentHealthIssueDetailData, required: An open Agent Health issue with available remediation.
    - `attributes` AgentHealthIssueDetailAttributes, required: Attributes of an open Agent Health issue, including available remediation.
      - `category` string: The category of the issue, such as `configuration`. Omitted when not set.
      - `description` string: The description of the issue. Omitted when empty.
      - `first_seen_at` string, date-time: The time the issue was first seen, in RFC 3339 format. Omitted when empty.
      - `issue_name` string, required: The human-readable name of the issue.
      - `issue_type` string, required: The machine-readable type of the issue.
      - `remediation` AgentHealthRemediation: Remediation for the issue. Omitted when no remediation is available.
        - `script` AgentHealthRemediationScript: A script that can be used to remediate the issue.
          - `content` string: The content of the script.
          - `filename` string: The filename of the script.
          - `language` string: The language of the script.
          - `language_version` string: The language version used by the script.
          - `requires_root` boolean: Whether the script requires root privileges.
        - `steps` AgentHealthRemediationStep[]: Steps to remediate the issue.
          - `order` integer: The order in which to perform the step.
          - `text` string: The instructions for the step.
        - `summary` string: A summary of how to remediate the issue.
      - `resource_id` string, required: The identifier of the affected resource, interpreted according to `resource_kind`: hostname for `host`, DaemonSet UID for `deployment` (node Agent), cluster UUID for `cluster`, hostname of the host running the Cluster Agent for `cluster_agent`, or OpenTelemetry collector ID for `otel`.
      - `resource_kind` string, required: The kind of affected resource. Known values are `host`, `deployment`, `cluster`, `cluster_agent`, and `otel`.
      - `resource_type` string: The type of the affected resource. Omitted when empty.
      - `severity` string, required: The severity of the issue. Known values are `low`, `medium`, `high`, and `unknown`.
      - `state` string, required: The state of the issue. Only issues with state `open` are returned.
      - `tags` string[]: Tags associated with the issue. Omitted when empty.
      - `title` string: The title of the issue. Omitted when empty.
      - `updated_at` string, date-time: The time the issue was last updated, in RFC 3339 format. Omitted when empty.
    - `id` string, required: The unique identifier of the issue.
    - `type` 'agent_health_issues', required: The Agent Health issue resource type.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `429`: Too many requests

## Changes

- **2026-11-12** `f63873c73fb1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/changes/api/v2/agenthealth/issues/:issue_id/get.md)

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/14d85160bfa9?raw)
