v53

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

Get agent policies

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/agent_policies</span></div>

Refer to Spaces for more information.

List all agent policies.<br/><br/>[Required authorization] Route required privileges: fleet-agent-policies-read OR fleet-agents-read OR fleet-setup.

get/api/fleet/agent_policies

Query parameters

pagenumber

Page number

perPagenumber

Number of results per page

sortFieldstring

Field to sort results by

sortOrder'desc' | 'asc'

Sort order, ascending or descending

showUpgradeableboolean

When true, only show policies with upgradeable agents

kuerystring

A KQL query string to filter results

noAgentCountboolean

use withAgentCount instead

withAgentCountboolean

get policies with agent count

fullboolean

get full policies with package policies populated

format'simplified' | 'legacy'

Format for the response: simplified or legacy

Response

Successful response

pagenumber required
perPagenumber required
totalnumber required