v53

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-076771,7565.2 MB
Fleet managed integrations

Bulk upgrade managed integrations

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/managed_integrations/_upgrade</span></div>

Refer to Spaces for more information.

Upgrade multiple managed integrations to their installed package version, migrating each package policy's config onto the new schema. Always returns 200 with a per-policy result array; a missing id, or an id that is not a managed integration, is reported as a per-item failure (success: false + statusCode) without failing the batch, so valid ids are still upgraded. A successful result means the policy's saved object was upgraded, while the agentless deployment is reconciled asynchronously in the background. Policies already at the installed version are a genuine no-op: they still report success: true (calls stay idempotent) but nothing is re-persisted or redeployed. Note: agent-policy-level agentless settings (resources, ownership tags) are not re-derived from the new package version — use the update (PUT) endpoint for those.

post/api/fleet/managed_integrations/_upgrade

Headers

kbn-xsrfstring required
Example:true

A required header to protect against CSRF attacks

Request body

policyIdsstring[] required

IDs of the managed integrations to upgrade to their installed package version.

Response

Indicates a successful response. Each item reports the per-policy upgrade outcome; inspect every item's success flag. A missing id, or an id that is not a managed integration, is reported as a per-item failure (success: false + statusCode) without failing the batch.

idstring required

The ID of the managed integration.

namestring

The name of the managed integration.

statusCodenumber

HTTP-like status code when the upgrade failed for this policy.

successboolean required

Whether the policy's saved object was upgraded successfully. The live workload is reconciled asynchronously in the background.