Delete application. Permanently removes an application from the enterprise. This action deletes the application record and its associated metadata, preventing it from being assigned to devices, policies, or blueprints. Once deleted, the application cannot be managed or distributed unless it is re-uploaded.

Common Use Cases

Removing deprecated or unsupported applications, cleaning up unused or test applications, eliminating duplicate entries, or decommissioning applications that are no longer approved for distribution.

Best Practices

Before deleting an application, download a copy for backup and archival purposes. To do this, navigate to the Apps section in the console and download the application package. Deletion is permanent and cannot be undone.

Additionally, ensure the application is not referenced in any blueprints prior to deletion. An application associated with a blueprint must be removed from that blueprint before it can be successfully deleted. Review device and blueprint assignments to avoid unintended disruption.

Workflow

Use the List apps in enterprise endpoint to retrieve the application_id.

Check whether the application is present in any blueprints by calling: GET https://{foo}-api.esper.cloud/api/v2/blueprints/

If the application appears in one or more blueprints, note the relevant blueprint_id values.

For each affected blueprint, update it to remove the application entry by calling: PUT https://{foo}-api.esper.cloud/api/v2/blueprints/{blueprint_id}/

After the application has been removed from all blueprints, call this endpoint with the application_id to permanently delete the application from the enterprise.