Skip to content

Esper Apps

Operations

Get esper app version details by ID
Stable

Request

Retrieves details for a specific version of an Esper App.

Given an app ID and version ID, returns the full EsperAppVersionResponse for that version — including its download URL, hashes, size, and platform metadata.

About Esper Apps

Esper Apps are Esper's own curated/system apps (as opposed to customer-uploaded tenant apps), spanning multiple platforms per the app_type field: TENANT_IOS, ESPER_IOS, ESPER_ANDROID, ESPER_LINUX, and ESPER_WINDOWS. Each app can have multiple versions, and this endpoint returns one specific version's detail.

Key Fields / Query Parameters

  • appId — UUID of the Esper App (path)
  • versionId — UUID of the specific app version (path)
  • X-Caller-Id — required request header
  • app_type — platform/type of the app (TENANT_IOS, ESPER_IOS, ESPER_ANDROID, ESPER_LINUX, ESPER_WINDOWS)
  • signature_hash — SHA-256 fingerprint of the app's signing key, only present for Android apps

Common Use Cases

  • Fetching download/version metadata for a specific Esper App version before deploying it
  • Verifying an app version's file hash or size prior to distribution
Security
apps_management_apiKey
Path
appIdstring, (uuid)required
versionIdstring, (uuid)required
cURL
curl -i -X GET \
  'https://api.esper.io/_mock/openapi/v2/esper-apps/{appId}/versions/{versionId}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Success

Bodyapplication/json
contentobject(apps_management_EsperAppVersionResponse)
Response
{
  "content": {
    "id": "string",
    "app_id": "string",
    "app_type": "TENANT_IOS",
    "app_name": "string",
    "app_icon_url": "string",
    "app_download_url": "string",
    "app_sha256_hash": "string",
    "signature_hash": "string",
    "architecture": "string",
    "release_notes": "string",
    "description": "string",
    "file_size_in_kb": 0,
    "device_family": [ … ],
    "version_name": "string",
    "build_number": "string",
    "min_sdk_version": "string",
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z",
    "created_by": "string",
    "updated_by": "string"
  }
}