Upload tenant app for a tenant

Uploads a new iOS or Windows app file to the tenant's app catalog.

Accepts a multipart file upload along with a platform value and returns the newly created app and version identifiers.

About Upload Tenant App

⚠️ iOS and Windows only. This is how enterprise apps for iOS and Windows devices get into Esper for later assignment to blueprints or installation via commands. If the appId already exists for a re-uploaded app, this call creates a new version under that app rather than a duplicate app record; confirm which behavior applies for your platform before assuming either outcome.

Key Fields / Request Body

platform — the target platform, APPLE or WINDOWS, required

file — the app binary to upload, required

Common Use Cases

Publishing a new iOS or Windows enterprise app for the first time

Uploading a new build of an already-published app as a new version

Best Practices

Capture both the id and version_id from the upload response immediately, since later calls may need either one

Confirm the platform value matches the actual file type before uploading, since this determines how the app is validated and distributed

Workflow

Prepare the app file and confirm its target platform

POST the file as multipart form data to this endpoint

Capture the returned id and version_id

Reference the app in a blueprint version or install command to distribute it to devices