---
title: "Delete app version"
method: DELETE
path: "/enterprise/{enterprise_id}/application/{application_id}/version/{version_id}/"
tags: ["esper_cloud_api_Application"]
---

# Delete app version

`DELETE /enterprise/{enterprise_id}/application/{application_id}/version/{version_id}/`

Alternative Available: DELETE /v1/enterprise/{enterprise_id}/application/{application_id}/version/{version_id}/ To remove an iOS or Windows application version: DELETE /v2/tenant-apps/{appId}/versions/{versionId}

Delete Android enterprise application version. Permanently removes a specific version of an application from the enterprise app catalog. Only the targeted version is deleted — the application record and all other versions remain intact and unaffected.

**Common Use Cases** Removing a buggy or recalled release, cleaning up test or development builds, and reducing catalog clutter by retiring outdated versions no longer approved for distribution.

Important behavior: You do not need to delete older versions before uploading a new one. Use this endpoint only when you want the selected version fully and permanently removed from the catalog.

**Best Practices** Before deleting, download and retain a copy of the build artifact outside of Esper — this action is irreversible and the version cannot be recovered through the API. Verify the version is not referenced in any active blueprints before calling this endpoint; a version associated with a blueprint must be removed from that blueprint first or the deletion will fail. Review any deployment **Workflow**s that may reference this specific version to avoid unintended disruption.

**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 remove. 3. Check whether the version is present in any blueprints: GET /v2/blueprints/ 4. If the version appears in one or more blueprints, note the relevant blueprint_id values. 5. For each affected blueprint, remove the version reference by calling: PUT /v2/blueprints/{blueprint_id}/ 6. Once the version has been removed from all blueprints, call this endpoint with the application_id and version_id to permanently delete it.

## Path parameters

- `version_id` string, uuid, required
- `application_id` string, uuid, required
- `enterprise_id` string, required

## Response `200`

No request id is provided and the application is linked to one or more templates. Returns a request_id. Call with this request id to delete the resource.

- EsperCloudApiAppVersionDelete
  - `request_id` string, uuid
  - `templates` object[] — List of linked templates to an app version
    - `id` integer — Id of the linked template
    - `name` string — Name of the linked template

## Other responses

- `204` — The resource was deleted successfully.
- `400` — Invalid request.
- `401` — Authorization information is missing or invalid.
- `403` — Forbidden, no permission to perform this action.
- `404` — Not Found.
- `500` — Internal server error

---

[API](https://skmtc.dev/esper/apis/esper-api-reference.md) · [All operations](https://skmtc.dev/esper/apis/esper-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/esper/esper-api-reference/revisions/e1f64cbb488e/schema)