esper_cloud_api_Device Group

Get thumbnail detail

Retrieves a single device group thumbnail by its ID.

Returns the details of one previously-uploaded thumbnail image, identified by thumbnail_id. Use List thumbnail pics to find available thumbnail IDs.

About Device Group Thumbnails Device Group thumbnails are purely cosmetic images used to visually distinguish groups in the Console UI.

Key Fields / Query Parameters

  • thumbnail_id — ID of the thumbnail image to retrieve

Common Use Cases

  • Confirming a specific thumbnail's image URL before applying it to a group
  • Verifying a thumbnail still exists prior to deleting or reassigning it
  • Displaying a specific thumbnail in a custom admin tool built on the Esper API

Best Practices

  • Use the list endpoint to find valid thumbnail_id values rather than guessing
  • Re-check a thumbnail's existence here before referencing it elsewhere, since it may have been deleted
  • Cache thumbnail URLs client-side rather than re-fetching repeatedly, since thumbnails rarely change

Workflow

  1. List thumbnails to find the target thumbnail_id
  2. GET this endpoint to confirm details before use
  3. Apply the thumbnail_id to a device group as needed
get/enterprise/{enterprise_id}/devicegroup/thumbnail/{thumbnail_id}/

Request

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

Path parameters

enterprise_idstring uuid required

Enterprise ID

thumbnail_idstring uuid required

Group thumbnail ID

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.