---
title: "Update a managed integration"
method: PUT
path: "/api/fleet/managed_integrations/{policyId}"
tags: ["Fleet managed integrations"]
---

# Update a managed integration

`PUT /api/fleet/managed_integrations/{policyId}`

**Spaces method and path for this operation:**

<div><span class="operation-verb put">put</span>&nbsp;<span class="operation-path">/s/{space_id}/api/fleet/managed_integrations/{policyId}</span></div>

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

Update a managed integration by ID. Uses full-replace semantics: the policy is rebuilt entirely from the request body, so any omitted optional field (for example, `description`, `vars`, `global_data_tags`, `cloud_connector`) is cleared or reset to its default. The integration package name is immutable and the runtime-managed `cluster_id` is preserved from the existing policy.

## Path parameters

- `policyId` string, required

## Headers

- `kbn-xsrf` string, required

## Request body

- KibanaHTTPAPIsCreateManagedIntegrationRequest
  - `additional_datastreams_permissions` string[], nullable — Additional data stream permissions that will be added to the agent policy.
  - `cloud_connector` object, nullable
    - `cloud_connector_id` string — ID of an existing cloud connector to reuse. If not provided, a new connector is created. Requires `enabled: true` and cannot be combined with `name`.
    - `enabled` boolean — Set to `true` to attach a cloud connector to this policy. Must be `true` to set any of `cloud_connector_id`, `name`, or `target_csp`.
    - `name` string — Name for a new cloud connector. If not provided, a name is generated automatically from the credentials. Requires `enabled: true` and only applies when creating a new connector (cannot be combined with `cloud_connector_id`).
    - `target_csp` 'aws' | 'azure' | 'gcp' — Target cloud service provider. If not provided, the provider is detected automatically from the inputs. Requires `enabled: true`.
  - `create_dataset_templates` boolean — When true, install dedicated index templates for streams with a custom data_stream.dataset. Defaults to true for input packages, false for integration packages.
  - `description` string — Policy description.
  - `force` boolean — Force package policy creation even if the package is not verified, or if the agent policy is managed.
  - `global_data_tags` object[]
    - `name` string, required — Name of the custom field. The name cannot contain spaces.
    - `value` union, required — Value of the custom field.
      - string
      - number
  - `id` string — Policy unique identifier.
  - `inputs` object — Package policy inputs. Refer to the integration documentation to know which inputs are available.
  - `name` string, required — Unique name for the policy.
  - `namespace` string — Policy namespace. When not specified, it inherits the agent policy namespace.
  - `package` KibanaHTTPAPIsPackagePolicyPackage, required
    - `experimental_data_stream_features` object[]
      - `data_stream` string, required
      - `features` object, required
        - `doc_value_only_numeric` boolean
        - `doc_value_only_other` boolean
        - `synthetic_source` boolean
        - `tsdb` boolean
    - `fips_compatible` boolean
    - `name` string, required — Package name
    - `requires_root` boolean
    - `title` string
    - `version` string, required — Package version
  - `policy_template` string — The policy template to use for the managed integration. If not provided, the default policy template is used.
  - `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.

## Response `200`

Indicates a successful response

- KibanaHTTPAPIsManagedIntegrationResponse
  - `item` KibanaHTTPAPIsManagedIntegration, required
    - `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.

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `409` — Conflict — for example, the requested name is already used by another integration policy.

---

[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)