esper_cloud_api_Tile Icon

Set a tile icon for a device

Applies a tile icon to one or more devices, groups, or a device model. Once used for earlier versions of the Blueprints experience.

Sets the specified icon as the tile icon for the target scope, determined by apply_mode — individual devices, all devices, device groups, or all devices of a given model.

About Device Tile Icons This endpoint controls how an icon is scoped when applied — a single call can update a specific list of devices, every device in one or more groups, every device of a given model, or the entire fleet, depending on apply_mode.

post/v1/enterprise/{enterprise_id}/tile-icon-apply/

Request

  • Base URL
    https://develop-api.esper.cloud/api
  • URL
    https://develop-api.esper.cloud/api/v1/enterprise/{enterprise_id}/tile-icon-apply/
  • Auth
    HTTP bearer

Path parameters

enterprise_idstring required

A UUID string identifying this enterprise.

Request body

iconstring uuid nullable
apply_mode'devices' | 'all_devices' | 'groups' | 'device_model'
device_modelstring nullable
groupsstring[]

Response

Successful Operation

iconstring uuid nullable
apply_mode'devices' | 'all_devices' | 'groups' | 'device_model'
device_modelstring nullable
groupsstring[]

Changes

No recorded changes to this operation across all 6 revisions of this API.