# Install a new application from ZIP file

Uploads and installs a new application from a ZIP archive. The application is created in a disabled state by default unless the 'enable' parameter is set to true.

RBAC: requires Apps.Manage

Endpoint: POST /api/v1/apps
Version: 1.0
Security: header

## Query parameters:

  - `enable` (boolean,null)
    Automatically enable the application after successful installation. Default is false.
    Example: true

## Request fields (multipart/form-data):

  - `file` (string, required)

## Response 200 fields (application/json):

  - `id` (string, required)
    UUID with type prefix
    Example: "us_01hxcvk1hjexere4pvtrj0ymqq"

  - `name` (string, required)

  - `manifest` (object, required)

  - `manifest.id` (string, required)

  - `manifest.description` (string, required)

  - `manifest.version` (string, required)

  - `manifest.releasedOn` (string, required)
    Example: "2022-03-10T16:15:50Z"

  - `manifest.developer` (object, required)

  - `manifest.developer.website` (string, required)

  - `manifest.icons` (array, required)

  - `manifest.previews` (array, required)

  - `manifest.routes` (array, required)

  - `manifest.routes.path` (string, required)

  - `manifest.routes.handler` (string,null)

  - `manifest.routes.entryPointFor` (string,null)
    Enum: "GLOBAL", "USER", "GROUP"

  - `manifest.routes.order` (integer)

  - `manifest.routes.permissions` (object,null)

  - `manifest.routes.permissions.anyOf` (array,null)

  - `manifest.routes.permissions.anyOf.resource` (string, required)
    The type-safe resource being controlled

  - `manifest.routes.permissions.anyOf.actions` (array, required)
    List of allowed type-safe actions for this resource

  - `manifest.routes.permissions.allOf` (array,null)

  - `manifest.visibility` (string, required)
    Enum: "PUBLIC", "UNLISTED"

  - `manifest.type` (string, required)
    Enum: "REGULAR", "ERROR", "TOOLBAR"

  - `manifest.standard` (boolean)

  - `enabled` (boolean)

  - `updatedAt` (string, required)
    Example: "2022-03-10T16:15:50Z"

## Response 400 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation

## Response 401 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation

## Response 403 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation

## Response 404 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation