v53

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

Bulk upgrade agents

Spaces method and path for this operation:

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

Refer to Spaces for more information.

Upgrade multiple agents to a newer version, with optional rollout controls.<br/><br/>[Required authorization] Route required privileges: fleet-agents-all.

post/api/fleet/agents/bulk_upgrade

Headers

kbn-xsrfstring required
Example:true

A required header to protect against CSRF attacks

Request body

batchSizenumber
dryRunboolean
forceboolean
includeInactiveboolean
rollout_duration_secondsnumber
skipRateLimitCheckboolean
source_uristring
start_timestring
versionstring required

Response

Successful response

OR