v1

latestOpenAPI 3.0.1Apache 2.02026-08-063494581.6 MB
esper_cloud_api_Application

Patch an App version instance

Alternative Available: PATCH /v1/enterprise/{enterprise_id}/application/{application_id}/version/{version_id}/ To update an iOS or Windows application version: PUT /v2/tenant-apps/{appId}/versions/{versionId}

Patch Android enterprise application version. Updates editable metadata for a specific application version without changing the underlying build. Use this endpoint to modify fields such as release name, release comments, release track, approval status, SDK targets, and whether the version is enabled or set as the default.

Common Use Cases Updating release notes or comments after upload, changing a version's release track (Alpha, Beta, or Production), enabling or disabling a specific version, setting a version as the default, and updating approval status as part of a review Workflow.

Important behavior: This endpoint does not upload or replace the app binary. To publish a new build, use: POST /enterprise/{enterprise_id}/application/upload/

Best Practices Only include the fields you intend to change — unspecified fields will remain unchanged. Confirm the version_id before patching to avoid updating the wrong release. If updating approval_status or is_enabled as part of a release Workflow, verify downstream policies and blueprints referencing this version are ready before making the version active. Workflow:

  1. Use the List apps in enterprise endpoint to retrieve the application_id.
  2. Use the List app versions endpoint to identify the version_id you want to update.
  3. Send a PATCH request with only the metadata fields you want to modify.
patch/enterprise/{enterprise_id}/application/{application_id}/version/{version_id}/

Path parameters

version_idstring uuid required

A UUID string identifying this app version.

application_idstring uuid required

A UUID string identifying this application.

enterprise_idstring required

A UUID string identifying enterprise.

Response

successful operation

idstring uuid
installed_countinteger
app_filestring url
app_iconstring url nullable
version_codestring required
build_numberstring nullable
size_in_mbnumber
hash_stringstring
release_namestring nullable
release_commentsstring nullable
release_track'Alpha' | 'Beta' | 'Production' nullable
created_onstring date-time
updated_onstring date-time
min_sdk_versionstring nullable
target_sdk_versionstring nullable
is_enabledboolean
is_defaultboolean
enterprisestring url required
applicationstring url
approval_status'AVAILABLE' | 'ACCEPTED' | 'APPROVED' | 'REJECTED'