---
title: "Install a package from the registry"
method: POST
path: "/api/fleet/epm/packages/{pkgName}"
tags: ["Elastic Package Manager (EPM)"]
---

# Install a package from the registry

`POST /api/fleet/epm/packages/{pkgName}`

**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/{pkgName}</span></div>

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

Install the latest version of a package from the Elastic Package Registry.<br/><br/>[Required authorization] Route required privileges: integrations-all AND fleet-agent-policies-all.

## Path parameters

- `pkgName` string, required

## Query parameters

- `prerelease` boolean
- `ignoreMappingUpdateErrors` boolean
- `skipDataStreamRollover` boolean
- `skipDependencyCheck` boolean

## Headers

- `kbn-xsrf` string, required

## Request body

- KibanaHTTPAPIsInstallPackageFromRegistryRequest
  - `allow_outdated_version` boolean — When true, allow installing a version older than the latest available. Bypasses only the out-of-date version check.
  - `force` boolean
  - `ignore_constraints` boolean

## Response `200`

Successful response

- KibanaHTTPAPIsInstallPackageResponse
  - `_meta` object, required
    - `install_source` string, required
    - `name` string, required
  - `items` union[], required
    - union
      - KibanaHTTPAPIsKibanaAssetReference
        - `deferred` boolean
        - `id` string, required
        - `originId` string
        - `type` union, required
          - 'dashboard' | 'lens' | 'visualization' | 'search' | 'index-pattern' | 'map' | 'ml-module' | 'security-rule' | 'csp-rule-template' | 'osquery-pack-asset' | 'osquery-saved-query' | 'tag'
          - string
      - KibanaHTTPAPIsEsAssetReference
        - `customDataStreamOriginDataset` string
        - `customDataStreamOriginType` string
        - `deferred` boolean
        - `id` string, required
        - `type` 'index' | 'index_template' | 'component_template' | 'ingest_pipeline' | 'ilm_policy' | 'data_stream_ilm_policy' | 'transform' | 'ml_model' | 'knowledge_base' | 'esql_view', required
        - `version` string

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