v53

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-076771,7565.2 MB
Elastic Agents

Get agents

Spaces method and path for this operation:

<div><span class="operation-verb get">get</span>&nbsp;<span class="operation-path">/s/{space_id}/api/fleet/agents</span></div>

Refer to Spaces for more information.

List agents, with optional filtering and pagination.<br/><br/>[Required authorization] Route required privileges: fleet-agents-read.

get/api/fleet/agents

Query parameters

pagenumber

Page number

perPagenumber

Number of results per page

kuerystring

A KQL query string to filter results

showAgentlessboolean

When true, include agentless agents in the results

showInactiveboolean

When true, include inactive agents in the results

withMetricsboolean

When true, include CPU and memory metrics in the response

showUpgradeableboolean

When true, only return agents that are upgradeable

getStatusSummaryboolean

When true, return a summary of agent statuses in the response

sortFieldstring

Field to sort results by

sortOrder'asc' | 'desc'

Sort order, ascending or descending

searchAfterstring

JSON-encoded array of sort values for search_after pagination

openPitboolean

When true, opens a new point-in-time for pagination

pitIdstring

Point-in-time ID for pagination

pitKeepAlivestring

Duration to keep the point-in-time alive, for example, 1m

Response

Successful response

nextSearchAfterstring
pagenumber required
perPagenumber required
pitstring
statusSummaryobject
totalnumber required