Deletes instance of wallpaper

Deletes instance of wallpaper
Stable

Request

Permanently deletes a wallpaper image from the enterprise identified by its UUID wallpaper_id. This action is irreversible. Since there is no dedicated wallpaper library in the Console, use GET /v1/enterprise/{enterprise_id}/wallpaper/ to confirm the correct wallpaper_id before deleting.

Common Use Cases

Removing outdated or superseded wallpaper images from the enterprise

Cleaning up duplicate or test wallpapers uploaded during setup

Decommissioning branding assets that are no longer in use

Best Practices

Verify the wallpaper is not currently referenced in any active blueprint before deleting — there is no Console warning to flag active references, and removing a wallpaper that is still assigned to a blueprint may result in those devices receiving no wallpaper on next convergence

Confirm the correct wallpaper_id using GET /v1/enterprise/{enterprise_id}/wallpaper/{wallpaper_id}/ before deleting — this action cannot be undone

If replacing a wallpaper rather than simply removing it, upload the new image first via POST /v1/enterprise/{enterprise_id}/wallpaper/, update all blueprint references to the new wallpaper_id, and then delete the old wallpaper

Security

esper_cloud_api_apiKey

Path

enterprise_idstringrequired

A UUID string identifying this enterprise.

wallpaper_idstringrequired

A UUID string identifying the wallpaper.

cURL

curl -i -X DELETE \
  'https://api.esper.io/_mock/openapi/v1/enterprise/{enterprise_id}/wallpaper/{wallpaper_id}/' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

The resource was deleted successfully.

Response

No content