v1

latestOpenAPI 3.0.02026-07-141,4077,1665.2 MB

CSM Settings

List unified hosts

Get the list of unified hosts for CSM, combining agent and agentless host data, with optional pagination and filtering.

get/api/v2/csm/settings/hosts

Query parameters

pageinteger

The page index for pagination (zero-based).

sizeinteger

Example:10

The number of hosts to return per page.

querystring

Example:source:agent

A search query string to filter unified hosts.

Response

Example response

{
  "data": [
    {
      "attributes": {
        "account_id": "123456789012",
        "agent_csm_vm_hosts_enabled": true,
        "agent_posture_management": true,
        "agent_version": "7.50.0",
        "agentless_vulnerability_scanning": true,
        "cloud_provider": "aws",
        "cluster_name": "my-cluster",
        "datadog_agent_key": "key123",
        "env": [
          "prod"
        ],
        "host_id": 12345678,
        "install_method_tool": "helm",
        "os": "linux",
        "resource_type": "aws_ec2_instance",
        "source": "agent"
      },
      "id": "i-0123456789abcdef0",
      "type": "unified_host"
    }
  ],
  "meta": {
    "page_size": 10,
    "total_filtered": 100,
    "total_pages": 10
  }
}