Storage exhaustion on Android devices: generate group storage report via EAST and bulk-clear app data via Group Command API

Android

When your Android devices run out of storage, they may crash or enter recovery mode, especially during app updates. This article explains how to identify devices with low storage in a group and clear app data in bulk to resolve the issue.

Before you begin

You'll need:

• Access to the Esper Console
• Your enterprise ID (found in Company Settings)
• Your group ID (visible in the URL when viewing the group in the Esper Console)
• An API token to make requests (for bulk clearing app data)

Step 1: Generate a storage report for your group

To identify which devices have low storage, generate a storage report using EAST (Esper Advanced Support Tool).

1. Log in to EAST using your Esper credentials.
2. Select your tenant and the target device group (for example, "Landry Devices").
3. Generate a device report export. The report will include device names, device IDs, and storage information (used and available space).
4. Download the report as an Excel file.
5. Use Excel's Filter feature to sort by available storage in ascending order. This will show you which devices have the least available space.

For more details, see Getting Started with EAST.

Step 2: Bulk clear app data via the Group Command API

Use the Esper API to clear application data across all affected devices in your group at once.

1. Prepare your API request. Use the following endpoint:

   POST https://<tenant_name>-api.esper.cloud/api/v0/enterprise/<enterprise_id>/command/

2. Format your request body as follows (replace values in angle brackets with your own):

   {
    "command_type": "GROUP",
    "command_args": {
    "package_name": "<package_name>",
    "application_name": "<application_name>",
    "is_g_play": true
    },
    "groups": [ "<group_id>" ],
    "group_type": "all",
    "command": "CLEAR_APP_DATA"
   }

3. Replace the following parameters:
   • <tenant_name> — your Esper tenant name
   • <enterprise_id> — found in the Esper Console under Company Settings
   • <group_id> — the ID of your target group (visible in the Esper Console URL)
   • <package_name> — the full Android package name, for example com.example.app
   • <application_name> — the display name of the app
   • is_g_play — set to true for Google Play apps, or false for enterprise or private APKs
4. Execute the request using Postman, curl, or another HTTP client. Include a valid Bearer token in the Authorization header.
5. Repeat this process for each app package that is consuming excessive storage.

Step 3: Update Esper Agent to the latest version

Keeping your Esper Agent current helps prevent storage-related issues and improves device stability.

1. In the Esper Console, go to Esper Software Updates.
2. Check the current Esper Agent version available on your tenant.
3. If your agent version is outdated, contact Esper Support to have the latest version pushed to your devices.
4. Review your Automatic Updates setting:
   • Automatic Updates ON: All devices will automatically update to the latest agent version once it is pushed.
   • Automatic Updates OFF: You can manually target specific devices via Pipelines to roll out updates in a controlled way.
5. After the update is complete, confirm that all devices in your group have received the new agent version.

Still need help?

If you've completed these steps and your devices still have storage issues, submit a support ticket. Include your group name, affected device count, and the storage report you generated in Step 1.