Skip to content

List webtokens
Stable

Request

List all web tokens for a Google Enterprise (EMM) instance. Retrieves all web tokens associated with the specified EMM binding, including each token's value, parent_url, active status, and creation timestamp. Retrieve your webtoken from the Apps section of the console by using the inspector's network tab.

About Web Tokens

A Google web token is a credential required to access the Managed Google Play interface within the Esper Console. Web tokens are also a key part of the EMM enterprise enrollment Workflow — if token generation or retrieval fails, it can block new device onboarding and prevent access to app management features entirely.

Common Use Cases

Retrieving existing web tokens to verify their active status before launching the Managed Play Store interface, auditing which parent_url values are authorized for console Google Play Store use, and obtaining a webtoken_id needed to update or delete a specific token.

Workflow

  1. Call GET /v0/enterprise/{enterprise_id}/emm/ to retrieve the emm_id for the enterprise's Google Enterprise binding.
  2. Call this endpoint to list all existing web tokens and check their active status and associated parent_url.
  3. If a suitable active token exists, use it to access the Managed Google Play interface for app selection, managed configurations, and Play Store customization.
Security
esper_cloud_api_apiKey
Path
enterprise_idstringrequired

A UUID string identifying this enterprise.

emm_idintegerrequired

An integer representing the ID of enterprise.

cURL
curl -i -X GET \
  'https://api.esper.io/_mock/openapi/v0/enterprise/{enterprise_id}/emm/{emm_id}/webtoken/' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

successful operation

Bodyapplication/json
countintegerrequired
nextstring or null, (url)
previousstring or null, (url)
resultsArray of objects(esper_cloud_api_GoogleWebToken)required
Response
{
  "count": 0,
  "next": "string",
  "previous": "string",
  "results": [
    { … }
  ]
}