Chromeosdevices: update

Updates a device's updatable properties, such as annotatedUser, annotatedLocation, notes, orgUnitPath, or annotatedAssetId. Try it now.


HTTP request



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.
deviceId string The unique ID of the device. The deviceIds are returned in the response from the chromeosdevices.list method.
Optional query parameters
projection string Restrict information returned to a set of selected fields.

Acceptable values are:
  • "BASIC": Includes only the basic metadata fields (e.g., deviceId, serialNumber, status, and user)
  • "FULL": Includes all metadata fields


This request requires authorization with the following scope:


For more information, see the authentication and authorization page.

Request body

In the request body, supply a Chromeosdevices resource with the following properties:

Property name Value Description Notes
Optional Properties
annotatedAssetId string The asset identifier as noted by an administrator or specified during enrollment. writable
annotatedLocation string The address or location of the device as noted by the administrator. Maximum length is 200 characters. Empty values are allowed. writable
annotatedUser string The user of the device as noted by the administrator. Maximum length is 100 characters. Empty values are allowed. writable
notes string Notes about this device added by the administrator. This property can be searched with the list method's query parameter. Maximum length is 500 characters. Empty values are allowed. writable
orgUnitPath string The full parent path with the organizational unit's name associated with the device. Path names are case insensitive. If the parent organizational unit is the top-level organization, it is represented as a forward slash, /. This property can be updated using the API. For more information about how to create an organizational structure for your device, see the administration help center. writable


If successful, this method returns a Chromeosdevices resource in the response body.

Try it!

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