v1

latestOpenAPI 3.0.1Apache 2.02026-08-063494581.6 MB
tenant_VPP Token Management

Delete VPP Token

⚠️ iOS/iPadOS/tvOS only.

Deletes a VPP token from the Esper tenant by its ID.

Once deleted, Esper can no longer distribute or manage Apple App Store apps associated with that token's Apple Business location; previously installed apps remain on devices but cannot be updated or reassigned through Esper.

About Delete VPP Token

VPP tokens link Esper to a specific Apple Business location for app license management. Removing a token from Esper does not revoke app licenses in Apple Business, but it ends Esper's ability to manage those licenses going forward. This action is appropriate when retiring an Apple Business location, replacing a token with a renewed one, or decommissioning iOS app management entirely. Use the id returned from GET /api/tenant/v0/vpptokens/ or POST /api/tenant/v0/vpptokens/ to identify the correct token.

Key Fields / Query Parameters

id (path, required, integer) — The identifier of the VPP token record to delete.

Common Use Cases

Removing an expired token before uploading a renewed one

Cleaning up a stale token from a retired Apple Business location

Decommissioning iOS app management for the tenant

Best Practices

Before deleting, verify that no active iOS devices are relying on app licenses managed through this token.

Upload a replacement token via POST /api/tenant/v0/vpptokens/ immediately after deletion to minimize disruption to app management.

Confirm the correct token using GET /api/tenant/v0/vpptokens/ before deleting, especially in tenants with multiple VPP tokens.

delete/tenant/v0/vpptokens/{id}

Path parameters

idinteger required

Response

Success

codeinteger

response code

messagestring

response message

contentobject