get:
  summary: List packages
  tags:
    - Elastic Package Manager (EPM)
  responses:
    '200':
      description: OK
      content:
        application/json:
          schema:
            $ref: ../components/schemas/get_packages_response.yaml
    '400':
      $ref: ../components/responses/error.yaml
  operationId: list-all-packages
  parameters:
    - in: query
      name: excludeInstallStatus
      schema:
        type: boolean
        default: false
      description: >-
        Whether to exclude the install status of each package. Enabling this option will opt in to
        caching for the response via `cache-control` headers. If you don't need up-to-date installation
        info for a package, and are querying for a list of available packages, providing this flag can
        improve performance substantially.
    - in: query
      name: prerelease
      schema:
        type: boolean
        default: false
      description: >-
        Whether to return prerelease versions of packages (e.g. beta, rc, preview)
    - in: query
      name: experimental
      deprecated: true
      schema:
        type: boolean
        default: false
    - in: query
      name: category
      schema:
        type: string
post:
  summary: Install by package by direct upload
  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:
                      - upload
                      - registry
                      - bundled
            required:
              - items
    '400':
      $ref: ../components/responses/error.yaml
  operationId: install-package-by-upload
  description: ''
  parameters:
    - $ref: ../components/headers/kbn_xsrf.yaml
  requestBody:
    content:
      application/zip:
        schema:
          type: string
          format: binary
      application/gzip:
        schema:
          type: string
          format: binary