Skip to content

Patch an App version instance
Stable

Request

Partially updates the metadata of a specific application version without modifying its APK or binary content.Use this endpoint to update human-readable labels. Only the fields included in the request body are modified; omitted fields remain unchanged.

About Patch App Version

Application versions in Esper carry both technical metadata (version code, minimum SDK, build number) and management metadata (release name, default flag, approval status). The PATCH operation enables targeted updates to either set without re-uploading the binary.

Key Fields / Query Parameters

release_name — Human-readable label for this version (e.g., "Q2 Release - Stable")

Common Use Cases

Updating a version description

Best Practices

Use version description such as PROD or DEV to differentiate between production and development builds

Workflow

Retrieve the current version details using GET /api/v1/enterprise/{enterprise_id}/application/{application_id}/version/{version_id}/ to confirm current field values. Construct a PATCH request body with only the fields to update. Submit the request and confirm the returned AppVersionV1 object reflects the expected changes.

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

is_defaultboolean(Is Default)

Is the app version the deafult

min_sdk_versionstring(Minimum SDK version)

Version number of minimum 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"
cURL
curl -i -X PATCH \
  'https://api.esper.io/_mock/openapi/v1/enterprise/{enterprise_id}/application/{application_id}/version/{version_id}/' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: */*' \
  -d '{
    "release_name": "string",
    "is_default": true,
    "min_sdk_version": "string",
    "build_number": "string",
    "version_code": "string",
    "approval_status": "AVAILABLE"
  }'

Responses

successful operation

Bodyapplication/json
idstring, (uuid)(Id)read-only
installed_countinteger(Installed count)read-only
is_g_playboolean(Is google play)
app_filestring or null, (url)(App file url)
app_iconstring or null, (url)(App icon url)
version_codestring or null, [ 1 .. 50 ] characters(Version code)required
build_numberstring or null, [ 1 .. 100 ] characters(Build number)
min_sdk_versionstring or null, [ 1 .. 10 ] characters(Minimum sdk version)
enterprisestring, (url)(Enterprise URL)required
applicationstring, (url)(Application URL)
release_namestring or null, <= 255 characters(Name of the release)
release_commentsstring or null(Release comments)
approval_statusstring, <= 50 characters(Approval Status)
Default:"APPROVED"
Enum:"AVAILABLE""ACCEPTED""APPROVED""REJECTED"
release_datestring, (date-time)(Release date)
size_in_mbnumber(Size in mb)
is_defaultboolean(Is default)
Default:false
created_onstring, (date-time)(Created on)read-only
Response
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "installed_count": 0,
  "is_g_play": true,
  "app_file": "string",
  "app_icon": "string",
  "version_code": "string",
  "build_number": "string",
  "min_sdk_version": "string",
  "enterprise": "string",
  "application": "string",
  "release_name": "string",
  "release_comments": "string",
  "approval_status": "AVAILABLE",
  "release_date": "2019-08-24T14:15:22Z",
  "size_in_mb": 0,
  "is_default": false,
  "created_on": "2019-08-24T14:15:22Z"
}