v1

latestOpenAPI 3.0.1Apache 2.02026-08-063494581.6 MB
esper_cloud_api_Wallpapers

Get instance of wallpaper

Returns the details of a single wallpaper image identified by its UUID wallpaper_id, including the full-resolution image URL, thumbnail URL, orientation, and active status. There is no dedicated wallpaper library in the Console — wallpapers are only visible by previewing the blueprint they are associated with, making this endpoint the primary way to retrieve details for a specific wallpaper programmatically.

Response fields of note

id — UUID identifying the wallpaper

image_file — URL of the full-resolution wallpaper image

thumbnail — URL of the thumbnail preview

orientation — Orientation of the image (e.g., landscape)

is_active — Whether the wallpaper is currently active

created_on / updated_on — Timestamps for auditing purposes

Common Use Cases

Retrieving wallpaper details to confirm a successful upload before referencing the wallpaper_id in a blueprint

Auditing the metadata of a specific wallpaper when the wallpaper_id is already known

Verifying the orientation or active status of a wallpaper before assigning it to a Windows blueprint

Best Practices

If the wallpaper_id is not already known, use GET /v1/enterprise/{enterprise_id}/wallpaper/ with timestamp filters to locate it — wallpapers are not browsable in the Console

This endpoint returns metadata and image URLs only; the image itself must be accessed directly via the image_file URL in the response

get/v1/enterprise/{enterprise_id}/wallpaper/{wallpaper_id}/

Path parameters

enterprise_idstring required

A UUID string identifying this enterprise.

wallpaper_idstring required

A UUID string identifying the wallpaper.

Response

successful operation

idstring uuid
enterprisestring uuid
image_filestring url
thumbnailstring url
orientationstring
is_activeboolean
created_onstring date-time
updated_onstring date-time