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}/

Request

  • Base URL
    https://develop-api.esper.cloud/api
  • URL
    https://develop-api.esper.cloud/api/enterprise/{enterprise_id}/application/{application_id}/version/{version_id}/
  • Auth
    HTTP bearer

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.

Request body */*

release_namestring

Name of the Release

release_commentsstring

Additional comments about the release

release_track'Alpha' | 'Beta' | 'Production'

Description of the content

is_enabledboolean

Is the app version enabled

min_sdk_versionstring

Version number of minimum SDK version that supports this app version

target_sdk_versionstring

Target SDK version that supports this app version

build_numberstring

Build number of this app version

version_codestring

Version code of this app version

approval_status'AVAILABLE' | 'ACCEPTED' | 'APPROVED' | 'REJECTED'

Approval status of this app version

is_defaultboolean

Is the app version default

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'

Changes

No recorded changes to this operation across all 6 revisions of this API.