Skip to content

Update the Google EMM Policy details for a specific device.
Stable

Request

Updates the Google EMM policy applications for a specific device.

Sets the applications list on the device's Google EMM policy; optional is_provisioning and is_converging query parameters indicate whether this update is happening as part of device provisioning or a converge operation.

About Device Google EMM Policy This endpoint pushes managed-application policy changes directly to a device's Google EMM enrollment. It is typically invoked by Esper's own provisioning and converge workflows rather than called ad hoc, hence the is_provisioning/is_converging flags.

Key Fields / Query Parameters

  • deviceId — UUID of the device to update
  • applications — List of managed applications to set in the device's Google EMM policy
  • is_provisioning — Whether this update is part of initial device provisioning
  • is_converging — Whether this update is part of a Blueprint converge operation
Path
deviceIdstring, (uuid)required

The unique identifier of the device for which Google account details need to be updated.

Query
is_provisioningstring

Flag indicating if provisioning is enabled (true or false). Default is false.

Default:"false"
is_convergingstring

Flag indicating if convergence is enabled (true or false). Default is false.

Default:"false"
Bodyapplication/jsonrequired
applicationsArray of objects(device_GoogleApplication)
cURL
curl -i -X PUT \
  'https://api.esper.io/_mock/openapi/v2/devices/{deviceId}/google-accounts/policy/?is_provisioning=false&is_converging=false' \
  -H 'Content-Type: application/json' \
  -d '{
    "applications": [
      {
        "product_id": "app:com.android.chrome",
        "mcm_id": "mcm_12345",
        "app_action": "install"
      }
    ]
  }'

Responses

Successfully updated the Google EMM policy details for the specified device.

Bodyapplication/json
contentobject(device_GoogleEMMDevice)
Response
{
  "content": {
    "android_id": "string",
    "management_type": "string",
    "policy": { … }
  }
}