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
- POST the image file to this endpoint
- Note the returned thumbnail_id
- 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 URLhttps://develop-api.esper.cloud/api
- URLhttps://develop-api.esper.cloud/api/enterprise/{enterprise_id}/devicegroup/thumbnail/
- AuthHTTP bearer
Path parameters
enterprise_idstring uuid required
Enterprise ID
Request body multipart/form-data
Response
Thumbnail
Changes
No recorded changes to this operation across all 6 revisions of this API.