Get list of wallpapers

Returns a paginated list of all wallpaper images uploaded to the enterprise. Each result includes the image URL, thumbnail URL, orientation, and active status. Wallpapers can be uploaded directly via the API or may have been added through a blueprint configuration.

Response fields of note

id — UUID identifying the wallpaper; used to reference it in Windows blueprint wallpaper settings

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

Discovering wallpaper_id values to reference in Windows blueprint homescreen or lock screen wallpaper settings

Verifying a wallpaper was successfully uploaded before referencing it in a blueprint

Building wallpaper selection UIs in custom management tools

Best Practices

Use timestamp filters to scope results when auditing recently added or modified wallpapers rather than fetching the full list

Store wallpaper_id UUIDs for use in Windows blueprint configuration — the wallpaper_id field appears in both homescreen and lock screen landscape settings

Note that wallpapers uploaded as part of a blueprint configuration will also appear in this list and can be reused across multiple blueprints