Upload an application to enterprise

⚠️ Android only. This endpoint accepts APK files and applies exclusively to Android-managed devices. See iOS and Windows application endpoints for Workflows.

Uploads an APK file to the enterprise application library, creating or updating an application and version record. Accepts a multipart/form-data payload with a single required field (app_file), and returns the resulting Application object including the newly created version upon success. This is the primary mechanism for adding privately distributed APKs to the Esper platform for enterprise deployment.

About Upload Application

The upload endpoint ingests an APK binary and parses it to extract metadata such as package name, version code, and SDK requirements, automatically associating the upload with the correct application record (creating one if none exists for the package name). The returned Application object includes the new version in its versions array.

Key Fields

app_file — required; the binary APK file to upload, sent as multipart/form-data

Common Use Cases

Add a new internal or privately distributed app to the enterprise library for managed deployment Upload a new version of an existing app, updating the version catalog without creating a duplicate application record Automate app updates as part of a CI/CD pipeline that pushes new APK builds to Esper. Use the Operations endpoint for large deployments.

Best Practices

Ensure the APK is valid and signed before uploading — malformed or unsigned APKs will result in a 400 Bad Request Store the application_id and version_id from the response to use directly in install commands without a subsequent lookup

Workflow

Build and sign your APK POST the APK binary as app_file in a multipart/form-data request to this endpoint Retrieve the application_id and new version_id from the response, then proceed with install Workflows