Skip to content

Upload a thumbnail pic
Stable

Request

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
Security
esper_cloud_api_apiKey
Path
enterprise_idstring, (uuid)required

Enterprise ID

Bodymultipart/form-datarequired
image_filestring, (binary)
cURL
curl -i -X POST \
  'https://develop-api.esper.io/_mock/openapi/enterprise/{enterprise_id}/devicegroup/thumbnail/' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: multipart/form-data' \
  -F image_file=string

Responses

Thumbnail

Bodyapplication/json
idstring, (uuid)read-only
image_filestringread-only
thumbnail_urlstringread-only
created_onstring, (date-time)read-only
Response
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "image_file": "string",
  "thumbnail_url": "string",
  "created_on": "2019-08-24T14:15:22Z"
}