Sign in

v53

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-076771,7565.2 MB
Fleet managed integrations

Update a managed integration

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

put/api/fleet/managed_integrations/{policyId}

Path parameters

policyIdstring required

The ID of the managed integration to update.

Headers

kbn-xsrfstring required
Example:true

A required header to protect against CSRF attacks

Request body

additional_datastreams_permissionsstring[] nullable

Additional data stream permissions that will be added to the agent policy.

create_dataset_templatesboolean

When true, install dedicated index templates for streams with a custom data_stream.dataset. Defaults to true for input packages, false for integration packages.

descriptionstring

Policy description.

forceboolean

Force package policy creation even if the package is not verified, or if the agent policy is managed.

idstring

Policy unique identifier.

inputsobject

Package policy inputs. Refer to the integration documentation to know which inputs are available.

namestring required

Unique name for the policy.

namespacestring

Policy namespace. When not specified, it inherits the agent policy namespace.

policy_templatestring

The policy template to use for the managed integration. If not provided, the default policy template is used.

var_group_selectionsobject

Variable group selections. Maps var_group name to the selected option name within that group.

varsobject

Input/stream level variable. Refer to the integration documentation for more information.

Response

Indicates a successful response