---
title: "Create a new version of existing package"
method: POST
path: "/packages/{packageId}/versions"
tags: ["packages"]
---

# Create a new version of existing package

`POST /packages/{packageId}/versions`

## Request

- Base URL: `https://pmp-demo.privateplatform.mendix.com/marketplaceservice/v1`
- URL: `https://pmp-demo.privateplatform.mendix.com/marketplaceservice/v1/packages/{packageId}/versions`
- Auth: one of:
  - HTTP basic
  - API key in header `Authorization`

### Use this POST operation to create a new version of an existing content item

Note:
- This operation will create a new Version of the existing package.
- The Status of the Version will be Draft.

## Path parameters

- `packageId` integer, required

## Request body

- VersionInput: Package version creation request
  - `description` string: Package version description.
  - `studioProVersion` string, required: Studio pro version that package version support.
  - `license` string: License name for package version.
  - `logoFile` string, required: Base64EncodedContent string of package version logo file.
  - `versionMajor` integer, required: Package version major number.
  - `versionMinor` integer, required: Package version minor number.
  - `versionPatch` integer, required: Package version patch number.
  - `releaseNotes` string, required: Package version release note text.
  - `documentation` string: Package version documentation text.
  - `sourceFileInput` object, required: Package version source mpk file.
    - `base64EncodedContent` string, required: Base64EncodedContent string of package version source mpk file.
    - `fileName` string, required: Package version source mpk file name.
  - `screenshotInputs` object[]: Package version screenshot file.
    - `base64EncodedContent` string: Base64EncodedContent string of package version screenshot file.
    - `fileName` string: Package version screenshot file name.

## Response `200`

Package version

- object
  - `id` string
  - `name` string
  - `description` string
  - `versionNum` string
  - `versionMajor` integer
  - `versionMinor` integer
  - `versionPatch` integer
  - `supportedStudioPro` string
  - `defaultVersion` boolean
  - `versionStatus` string
  - `logoUrl` string
  - `appViewUrl` string
  - `appDownloadUrl` string
  - `fileName` string
  - `releaseNotes` string
  - `documentation` string
  - `license` string
  - `supportLevel` string
  - `organisationName` string

## Other responses

- `400`: Invalid input parameters
- `401`: Authentication information missing or invalid
- `403`: No permission for this operation
- `404`: Resource not found

---

[API](https://skmtc.dev/mendix/apis/marketplace-service.md) - [All operations](https://skmtc.dev/mendix/apis/marketplace-service/llms.txt) - [OpenAPI document](https://skmtc.dev/mendix/apis/marketplace-service/revisions/8b2faa028606?raw)