esper_cloud_api_Device Group

Upload a thumbnail pic

Uploads an image to use as a thumbnail for a device group.

Uploads an image file that can subsequently be applied to represent a Device Group visually in the Devices & Groups section of the Esper Console. The image must be at least 180 x 180 px.

About Device Group Thumbnails Device Group thumbnails are purely cosmetic — they help admins visually distinguish groups in the Console UI and have no effect on device management, policies, or pipeline targeting.

Key Fields / Query Parameters

  • image_file — The image file to upload (multipart/form-data)

Common Use Cases

  • Uploading a custom icon to visually distinguish a store or region's device group in the Console
  • Building a library of group thumbnail images for a large multi-group organization
  • Standardizing group iconography across an enterprise's Console

Best Practices

  • Use recognizable, consistent imagery across groups to make the Console easier to navigate at a glance
  • Check List thumbnail pics first to avoid uploading duplicate images
  • Keep uploaded images reasonably sized for fast loading in the Console UI

Workflow

  1. POST the image file to this endpoint
  2. Note the returned thumbnail_id
  3. Reference that thumbnail_id when assigning the image to a device group in the Console or API
post/enterprise/{enterprise_id}/devicegroup/thumbnail/

Request

  • Base URL
    https://develop-api.esper.cloud/api
  • URL
    https://develop-api.esper.cloud/api/enterprise/{enterprise_id}/devicegroup/thumbnail/
  • Auth
    HTTP bearer

Path parameters

enterprise_idstring uuid required

Enterprise ID

Request body multipart/form-data

image_filestring binary

Response

Thumbnail

idstring uuid
image_filestring
thumbnail_urlstring
created_onstring date-time

Changes

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