---
title: "Preview a managed integrations upgrade"
method: POST
path: "/api/fleet/managed_integrations/_upgrade/dryrun"
tags: ["Fleet managed integrations"]
---

# Preview a managed integrations upgrade

`POST /api/fleet/managed_integrations/_upgrade/dryrun`

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

Refer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.

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`.

## Headers

- `kbn-xsrf` string, required

## Request body

- KibanaHTTPAPIsManagedIntegrationUpgradeDryRunRequest
  - `pkgVersion` string — Target package version to preview the upgrade against. Defaults to the installed package version.
  - `policyIds` string[], required — IDs of the managed integrations to preview upgrading.

## Response `200`

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.

- KibanaHTTPAPIsManagedIntegrationUpgradeDryRunResult[]
  - `body` object
    - `message` string, required — Error message when the dry-run failed for this policy.
  - `currentVersion` string — The current installed package version of the policy.
  - `errors` object[] — Migration errors encountered while computing the upgrade.
    - `message` string, required — Human-readable migration error.
  - `hasErrors` boolean, required — Whether the dry-run migration produced any errors.
  - `id` string, required — The ID of the managed integration.
  - `name` string — The name of the managed integration.
  - `proposedPolicy` KibanaHTTPAPIsManagedIntegration
    - `additional_datastreams_permissions` string[] — Additional data stream permissions granted to the managed integration.
    - `cloud_connector` KibanaHTTPAPIsManagedIntegrationCloudConnector
      - `cloud_connector_id` string, required — The ID of the cloud connector.
      - `enabled` boolean, required — Whether the cloud connector is active for this policy.
    - `created_at` string, required — Creation timestamp (ISO 8601).
    - `created_by` string, required — User who created the policy.
    - `description` string — Managed integration description.
    - `global_data_tags` object[] — Custom data tags applied to all data produced by this policy.
      - `name` string, required — The name of the custom field.
      - `value` union, required — The value of the custom field.
        - string
        - number
    - `id` string, required — Managed integration unique identifier.
    - `inputs` object, required — Package policy inputs. Refer to the integration documentation to know which inputs are available.
    - `name` string, required — Managed integration name.
    - `namespace` string — Policy namespace. Defaults to the agent policy namespace.
    - `package` KibanaHTTPAPIsManagedIntegrationPackage, required
      - `name` string, required — Integration package name.
      - `title` string, required — Integration package display title.
      - `version` string, required — Integration package version.
    - `updated_at` string, required — Last update timestamp (ISO 8601).
    - `updated_by` string, required — User who last updated the policy.
    - `var_group_selections` object — Variable group selections. Maps var_group name to the selected option name within that group.
    - `vars` object — Input/stream level variable. Refer to the integration documentation for more information.
  - `proposedVersion` string — The package version the policy would be upgraded to.
  - `statusCode` number — HTTP-like status code when the dry-run failed for this policy.

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/elastic/apis/kibana-apis.md) · [All operations](https://skmtc.net/elastic/apis/kibana-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elastic/kibana-apis/versions/531c9e2a7d23/schema)