get:
  summary: Get package
  tags:
    - Elastic Package Manager (EPM)
  responses:
    '200':
      description: OK
      content:
        application/json:
          schema:
            type: object
            allOf:
              - properties:
                  item:
                    $ref: ../components/schemas/package_info.yaml
              - properties:
                  status:
                    type: string
                    enum:
                      - installed
                      - installing
                      - install_failed
                      - not_installed
                  savedObject:
                    type: object
                    deprecated: true
                  latestVersion:
                    type: string
                  keepPoliciesUpToDate:
                    type: boolean
                  notice:
                    type: string
                  licensePath:
                    type: string
                required:
                  - status
                  - savedObject
    '400':
      $ref: ../components/responses/error.yaml
  operationId: get-package
  security:
    - basicAuth: []
parameters:
  - schema:
      type: string
    name: pkgName
    in: path
    required: true
  - schema:
      type: string
    name: pkgVersion
    in: path
    required: true
  - schema:
      type: boolean
    name: ignoreUnverified
    description: 'Ignore if the package is fails signature verification'
    in: query
  - schema:
      type: boolean
    name: full
    description: 'Return all fields from the package manifest, not just those supported by the Elastic Package Registry'
    in: query
  - in: query
    name: prerelease
    schema:
      type: boolean
      default: false
    description: >-
      Whether to return prerelease versions of packages (e.g. beta, rc, preview)
post:
  summary: Install package
  tags:
    - Elastic Package Manager (EPM)
  responses:
    '200':
      description: OK
      content:
        application/json:
          schema:
            type: object
            properties:
              items:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                    type:
                      oneOf:
                        - $ref: ../components/schemas/kibana_saved_object_type.yaml
                        - $ref: ../components/schemas/elasticsearch_asset_type.yaml
                  required:
                    - id
                    - type
              _meta:
                type: object
                properties:
                  install_source:
                    type: string
                    enum:
                      - registry
                      - upload
                      - bundled
            required:
              - items
    '400':
      $ref: ../components/responses/error.yaml
  operationId: install-package
  description: ''
  parameters:
    - $ref: ../components/headers/kbn_xsrf.yaml
  requestBody:
    content:
      application/json:
        schema:
          type: object
          properties:
            force:
              type: boolean
            ignore_constraints:
              type: boolean
put:
  summary: Update package settings
  tags:
    - Elastic Package Manager (EPM)
  responses:
    '200':
      description: OK
      content:
        application/json:
          schema:
            type: object
            properties:
              items:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                    type:
                      oneOf:
                        - $ref: ../components/schemas/kibana_saved_object_type.yaml
                        - $ref: ../components/schemas/elasticsearch_asset_type.yaml
                  required:
                    - id
                    - type
            required:
              - items
    '400':
      $ref: ../components/responses/error.yaml
  operationId: update-package
  description: ''
  requestBody:
    content:
      application/json:
        schema:
          type: object
          properties:
            keepPoliciesUpToDate:
              type: boolean
delete:
  summary: Delete package
  tags:
    - Elastic Package Manager (EPM)
  responses:
    '200':
      description: OK
      content:
        application/json:
          schema:
            type: object
            properties:
              items:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                    type:
                      oneOf:
                        - $ref: ../components/schemas/kibana_saved_object_type.yaml
                        - $ref: ../components/schemas/elasticsearch_asset_type.yaml
                  required:
                    - id
                    - type
            required:
              - items
    '400':
      $ref: ../components/responses/error.yaml
  operationId: delete-package
  parameters:
    - $ref: ../components/headers/kbn_xsrf.yaml
    - schema:
        type: boolean
      name: force
      description: delete package even if policies used by agents
      in: query
  requestBody:
    content:
      application/json:
        schema:
          type: object
          deprecated: true
          properties:
            force:
              type: boolean