Get tenant app versions by app ID

Retrieves a paginated list of every version uploaded for a specific tenant app.

Returns each version's TenantAppVersionResponse record. The legacy_format parameter controls whether version identification is returned as the legacy build_number or the newer version_code.

About Get Tenant App Versions

⚠️ iOS and Windows only. Every time a new build of a tenant app is uploaded, it becomes a new version under the same appId. This endpoint lists all of them, which is the standard way to find the version_id needed to install a specific build or to reference in a blueprint.

Key Fields / Query Parameters

legacy_format — when true (the default), returns build_number for backward compatibility; set to false to receive version_code instead

app_name — filters by app name

Common Use Cases

Finding the latest version of an app before assigning it to a blueprint

Auditing the upload history of a tenant app

Best Practices

Set legacy_format to false in new integrations to work with version_code directly, rather than relying on the legacy build_number field

Sort or filter results to confirm you're referencing the intended version before using it in a blueprint or install command

Workflow

Call this endpoint with the appId

Identify the versionId of the version you need

Call GET /v2/tenant-apps/{appId}/versions/{versionId} for that version's full detail