v1

latestOpenAPI 3.0.02026-07-141,4077,1665.2 MB

Fleet Automation

List all Datadog Agents

Retrieve a paginated list of all Datadog Agents. This endpoint returns a paginated list of all Datadog Agents with support for pagination, sorting, and filtering. Use the page_number and page_size query parameters to paginate through results.

get/api/unstable/fleet/agents

Query parameters

page_numberinteger

Page number for pagination (starts at 0).

page_sizeinteger

Number of results per page (must be greater than 0 and less than or equal to 100).

sort_attributestring

Attribute to sort by.

sort_descendingboolean

Sort order (true for descending, false for ascending).

tagsstring

Comma-separated list of tags to filter agents.

filterstring

Filter string for narrowing down agent results.

Response

Example response

{
  "data": {
    "attributes": {
      "agents": [
        {
          "agent_version": "7.50.0",
          "api_key_name": "Production API Key",
          "api_key_uuid": "a1b2c3d4-e5f6-4321-a123-123456789abc",
          "cloud_provider": "aws",
          "datadog_agent_key": "my-agent-hostname",
          "hostname": "my-hostname",
          "os": "linux",
          "remote_agent_management": "enabled",
          "remote_config_status": "connected"
        }
      ]
    },
    "id": "done",
    "type": "status"
  },
  "meta": {
    "total_filtered_count": 150
  }
}