Elastic Package Manager (EPM)

Install a package by upload

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/epm/packages</span></div>

Refer to Spaces for more information.

Install a package by uploading a .zip or .tar.gz archive (max 100MB).

Archives that contain Kibana assets requiring additional privileges are subject to a preflight authorization check before the package is installed. Privileges are checked in every space the package will be installed into.

The following asset types require the corresponding Kibana API privilege:

  • security_rule: rules-all
  • security_rule with type machine_learning: rules-all and ml:canCreateJob
  • security_ai_prompt: elasticAssistant

If any required privilege is missing, the request returns 403 and no assets are written. To learn more, refer to Upload an integration to Kibana.<br/><br/>[Required authorization] Route required privileges: integrations-all AND fleet-agent-policies-all.

post/api/fleet/epm/packages

Query parameters

ignoreMappingUpdateErrorsboolean

When true, ignore mapping update errors during installation

skipDataStreamRolloverboolean

When true, skip data stream rollover after installation

Headers

kbn-xsrfstring required
Example:true

A required header to protect against CSRF attacks

Response

Successful response

Changes

Changed in 1 of the 176 revisions of this API.1

Of the 176 revisions, 20 have no diff computed.