---
title: "Deletes instance of wallpaper"
method: DELETE
path: "/v1/enterprise/{enterprise_id}/wallpaper/{wallpaper_id}/"
tags: ["esper_cloud_api_Wallpapers"]
---

# Deletes instance of wallpaper

`DELETE /v1/enterprise/{enterprise_id}/wallpaper/{wallpaper_id}/`

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

## Path parameters

- `enterprise_id` string, required
- `wallpaper_id` string, required

## Response `204`

The resource was deleted successfully.

## Other responses

- `400` — Invalid request.
- `401` — Authorization information is missing or invalid.
- `403` — Forbidden, no permission to perform this action.
- `404` — Not Found.
- `500` — Internal server error

---

[API](https://skmtc.net/esper/apis/esper-api-reference.md) · [All operations](https://skmtc.net/esper/apis/esper-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/esper/esper-api-reference/revisions/e1f64cbb488e/schema)