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
Path parameters
A UUID string identifying this enterprise.
A UUID string identifying the wallpaper.
Response
successful operation