Warning: The Notifications API is deprecated and will be shutdown soon.

Mobiledevices: action

Takes an action that affects a mobile device. For example, remotely wiping a device. Try it now.


HTTP request

POST https://www.googleapis.com/admin/directory/v1/customer/customerId/devices/mobile/resourceId/action


Parameter name Value Description
Path parameters
customerId string The unique ID for the customer's G Suite account. As an account administrator, you can also use the my_customer alias to represent your account's customerId. The customerId is also returned as part of the Users resource.
resourceId string The unique ID the API service uses to identify the mobile device.


This request requires authorization with at least one of the following scopes:


For more information, see the authentication and authorization page.

Request body

In the request body, supply data with the following structure:

  "action": string
Property name Value Description Notes
action string The action to be performed on the device.

Acceptable values are:
  • "admin_account_wipe": Remotely wipes only G Suite data from the device. See the administration help center for more information.
  • "admin_remote_wipe": Remotely wipes all data on the device. See the administration help center for more information.
  • "approve": Approves the device. If you've selected Enable device activation, devices that register after the device activation setting is enabled will need to be approved before they can start syncing with your domain. Enabling device activation forces the device user to install the Device Policy app to sync with G Suite.
  • "block": Blocks access to G Suite data (mail, calendar, and contacts) on the device. The user can still access their mail, calendar, and contacts from a desktop computer or mobile browser.
  • "cancel_remote_wipe_then_activate": Cancels a remote wipe of the device and then reactivates it.
  • "cancel_remote_wipe_then_block": Cancels a remote wipe of the device and then blocks it.


If successful, this method returns an empty response body.

Try it!

Use the APIs Explorer below to call this method on live data and see the response.