v53

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-076771,7565.2 MB
Fleet agentless policies

Deprecated: Preview a managed integrations upgrade

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

Refer to Spaces for more information.

Deprecated. Use POST /api/fleet/managed_integrations/_upgrade/dryrun instead. Preview upgrading multiple managed integrations without applying any change. Targets the installed package version by default; pass pkgVersion to preview a specific (for example, not-yet-installed) version. Each result returns the current/proposed version and any migration errors, plus — only on a clean dry-run (hasErrors: false) — the migrated proposedPolicy. proposedPolicy is for the edit-and-upgrade flow (edit it, then save via the update (PUT) endpoint); to apply an upgrade as-is, use _upgrade.

post/api/fleet/agentless_policies/_upgrade/dryrun

Headers

kbn-xsrfstring required
Example:true

A required header to protect against CSRF attacks

Request body

pkgVersionstring

Target package version to preview the upgrade against. Defaults to the installed package version.

policyIdsstring[] required

IDs of the managed integrations to preview upgrading.

Response

Indicates a successful response. Each clean item (hasErrors: false) previews the migrated policy as a consumable managed integration (proposedPolicy); a missing id, an id that is not a managed integration, or a migration error, is reported as a per-item failure (hasErrors: true, with proposedPolicy omitted) without failing the batch. Inspect every item.

currentVersionstring

The current installed package version of the policy.

hasErrorsboolean required

Whether the dry-run migration produced any errors.

idstring required

The ID of the managed integration.

namestring

The name of the managed integration.

proposedVersionstring

The package version the policy would be upgraded to.

statusCodenumber

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