Skip to content

Patch an App version instance
Stable

Request

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.
Security
esper_cloud_api_apiKey
Path
version_idstring, (uuid)required

A UUID string identifying this app version.

application_idstring, (uuid)required

A UUID string identifying this application.

enterprise_idstringrequired

A UUID string identifying enterprise.

Body*/*
release_namestring(Release name)

Name of the Release

release_commentsstring(Release comments)

Additional comments about the release

release_trackstring(Release track)

Description of the content

Enum:"Alpha""Beta""Production"
is_enabledboolean(Is Enabled)

Is the app version enabled

min_sdk_versionstring(Minimum SDK version)

Version number of minimum SDK version that supports this app version

target_sdk_versionstring(Target SDK version)

Target SDK version that supports this app version

build_numberstring(Build Number)

Build number of this app version

version_codestring(Version Code)

Verion code of this app version

approval_statusstring(Approval Status)

Approval status of this app version

Enum:"AVAILABLE""ACCEPTED""APPROVED""REJECTED"
is_defaultboolean(Is default)

Is the app version default

cURL
curl -i -X PATCH \
  'https://api.esper.io/_mock/openapi/enterprise/{enterprise_id}/application/{application_id}/version/{version_id}/' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: */*' \
  -d '{
    "release_name": "string",
    "release_comments": "string",
    "release_track": "Alpha",
    "is_enabled": true,
    "min_sdk_version": "string",
    "target_sdk_version": "string",
    "build_number": "string",
    "version_code": "string",
    "approval_status": "AVAILABLE",
    "is_default": true
  }'

Responses

successful operation

Bodyapplication/json
idstring, (uuid)(Id)read-only
installed_countinteger(Installed count)read-only
permissionsArray of objects(esper_cloud_api_AppPermission)required
app_filestring, (url)(App file)read-only
app_iconstring or null, (url)(App icon)read-only
version_codestring, [ 1 .. 50 ] characters(Version code)required
build_numberstring or null, [ 1 .. 100 ] characters(Build number)
size_in_mbnumber(Size in mb)
hash_stringstring(Hash string)
release_namestring or null, [ 1 .. 255 ] characters(Release name)
release_commentsstring or null, non-empty(Release comments)
release_trackstring or null(Release track)
Enum:"Alpha""Beta""Production"
created_onstring, (date-time)(Created on)read-only
updated_onstring, (date-time)(Updated on)read-only
min_sdk_versionstring or null, [ 1 .. 10 ] characters(Min sdk version)
target_sdk_versionstring or null, [ 1 .. 10 ] characters(Target sdk version)
is_enabledboolean(Is enabled)
is_defaultboolean(Is Default)
enterprisestring, (url)(Enterprise)required
applicationstring, (url)(Application)
approval_statusstring(Application status)
Enum:"AVAILABLE""ACCEPTED""APPROVED""REJECTED"
Response
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "installed_count": 0,
  "permissions": [
    { … }
  ],
  "app_file": "string",
  "app_icon": "string",
  "version_code": "string",
  "build_number": "string",
  "size_in_mb": 0,
  "hash_string": "string",
  "release_name": "string",
  "release_comments": "string",
  "release_track": "Alpha",
  "created_on": "2019-08-24T14:15:22Z",
  "updated_on": "2019-08-24T14:15:22Z",
  "min_sdk_version": "string",
  "target_sdk_version": "string",
  "is_enabled": true,
  "is_default": true,
  "enterprise": "string",
  "application": "string",
  "approval_status": "AVAILABLE"
}