---
title: "Prepare a stored package version upload"
method: POST
path: "/softwareapps/{software_app_id}/stored-package-versions"
tags: ["Software Apps"]
---

# Prepare a stored package version upload

`POST /softwareapps/{software_app_id}/stored-package-versions`

## Request

- Base URL: `https://console.jumpcloud.com/api/v2`
- URL: `https://console.jumpcloud.com/api/v2/softwareapps/{software_app_id}/stored-package-versions`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2/docs/softwareapps/:software_app_id/stored-package-versions/post.ts> (a function with typed inputs; its response is checked against the schema)

Prepares a stored package version upload for a software app.

## Headers

- `x-org-id` string

## Request body

- SoftwareAppStoredPackageVersionRequest: Software app stored package version request
  - `name` string, required: The name of the package.
  - `size` integer, required: The size of the package.
  - `displayVersion` string: Optional display version for the package. Defaults to "Version N" when omitted.

## Response `201`

Created

- SoftwareAppStoredPackageVersionResponse: Software app stored package version response
  - `uploadUrl` string, required: The upload URL for the package.
  - `pendingVersionObjectId` string, required: The object ID of the pending version.
  - `metadata` DevicesObjectStorageMetadata
    - `metadataExe` DevicesMetadataEXE: MetadataEXE holds parsed metadata for a Windows .exe installer (NSIS, Inno Setup, etc.).
      - `arch` string
      - `author` string
      - `installerEngineVersion` string
      - `sha256sum` string
      - `signatureLabel` string
      - `size` integer
      - `title` string
      - `url` string
      - `version` string
    - `metadataFile` DevicesMetadataFile
      - `mimeType` string
      - `sha256sum` string
      - `size` integer
    - `metadataIpa` DevicesMetadataIPA
      - `assetKind` string
      - `bundleIdentifier` string
      - `bundleVersion` string
      - `packageKind` string
      - `sha256sum` string
      - `shortVersion` string
      - `subtitle` string
      - `title` string
    - `metadataMsi` DevicesMetadataMSI
      - `manufacturer` string
      - `productCode` string
      - `productName` string
      - `productVersion` string
      - `sha256sum` string
      - `upgradeCode` string
    - `metadataPkg` DevicesMetadataPKG
      - `assetKind` string
      - `bundleIdentifier` string
      - `bundleVersion` string
      - `managedInstallEligibilityStatus` 'MANAGED_INSTALL_ELIGIBILITY_NOT_EVALUATED' | 'MANAGED_INSTALL_ELIGIBLE' | 'MANAGED_INSTALL_INELIGIBLE' | 'MANAGED_INSTALL_ELIGIBILITY_UNKNOWN'
      - `packageKind` string
      - `sha256sum` string
      - `shortVersion` string
      - `subtitle` string
      - `title` string

## Other responses

- `400`: Bad Request
- `401`: Unauthenticated
- `403`: Unauthorized
- `404`: Not Found
- `409`: Conflict
- `500`: Internal Server Error

---

[API](https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2.md) - [All operations](https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2/revisions/3f09fe63caaa?raw)