Type to search.

Deprecated: Bulk upgrade managed integrations

Base URL
https://{kibana_url}
  • POST /api/fleet/agentless_policies/_upgrade
Auth The Elastic Stack includes Elastic's core products such as Elasticsearch, Kibana, Logstash, and Beats. Availability Experimental since 9.5 This functionality is experimental and is not ready for production usage. Experimental features may change or be removed at any time. Elastic will work to fix any issues, but experimental features are not subject to the support SLA of official GA features. Specific Support terms apply. Unless stated otherwise on the page, this functionality is available when your Elastic Stack is deployed on Elastic Cloud Hosted, Elastic Cloud Enterprise, Elastic Cloud on Kubernetes, and self-managed environments. This documentation corresponds to the latest patch available for each minor version. If you're not using the latest patch, check the release notes for changes.

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.

Header parameters

kbn-xsrf string required

A required header to protect against CSRF attacks

Request body

policyIds string[] · max items: 1000 required

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

Responses

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.

application/json
<array> object[] · max items: 10000
id string · max length: 256 required

The ID of the managed integration.

name string · max length: 256

The name of the managed integration.

statusCode number

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

success boolean required

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