Fleet agentless policies

Deprecated: 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/agentless_policies/_upgrade</span></div>

Refer to Spaces for more information.

Deprecated. Use POST /api/fleet/managed_integrations/_upgrade instead. 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/agentless_policies/_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.

Changes

No recorded changes to this endpoint across all 106 revisions of this API.