Skip to content

Get webtoken instance
Stable

Request

Get a specific web token for a Google Enterprise (EMM) instance. See Setting Up Google Play for more information. Retrieves the details of a single web token identified by webtoken_id, including its token value, associated emm ID, parent_url, active status, and creation timestamp.

Common Use Cases Verifying the active status and parent_url of a specific token before using it to render the Managed Google Play iFrame, retrieving token details for auditing or troubleshooting app management issues, and confirming a token's configuration before updating or deleting it.

Workflow:

  1. Call GET /v0/enterprise/{enterprise_id}/emm/ to retrieve the emm_id for the enterprise's Google Enterprise binding.
  2. Call GET /v0/enterprise/{enterprise_id}/emm/{emm_id}/webtoken/ to list all web tokens and identify the webtoken_id for the token you want to inspect.
  3. Call this endpoint to retrieve the full details of the specific token.
  4. If the token is active and the parent_url is correct, use the token value to authenticate the Managed Google Play iFrame.
  5. Use PUT /v0/enterprise/{enterprise_id}/emm/{emm_id}/webtoken/{webtoken_id}/ to update the token, or DELETE to remove it if it is no longer needed. After deleting, reach out to Esper Support.
Security
esper_cloud_api_apiKey
Path
enterprise_idstringrequired

A UUID string identifying this enterprise.

emm_idintegerrequired

An integer representing the ID of enterprise.

webtoken_idstringrequired

An integer identifying the webtoken.

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

Responses

successful operation

Bodyapplication/json
idinteger(Id)
emminteger(emm Id)
tokenstring(Webtoken)
parent_urlstring, (url)
is_activeboolean
created_onstring, (date-time)
Response
{
  "id": 0,
  "emm": 0,
  "token": "string",
  "parent_url": "string",
  "is_active": true,
  "created_on": "2019-08-24T14:15:22Z"
}