---
title: "Delete webclip for a tenant"
method: DELETE
path: "/v2/webclips/{webclipId}"
tags: ["apps_management_Webclips"]
---

# Delete webclip for a tenant

`DELETE /v2/webclips/{webclipId}`

⚠️ Apple devices only.

Deletes a specific webclip from the tenant library by its Esper UUID, returning the deleted webclip record.
The deletion is permanent. A 409 response indicates the webclip cannot be deleted because it is currently referenced by an active blueprint or configuration.

**About Delete Webclip**

Deleting a webclip removes it from the tenant library and makes it unavailable for new deployments. The 200 response returns the complete Webclip record for the deleted entry — retain it for audit purposes. The 409 Conflict response is significant: it indicates the webclip is still referenced in a blueprint or active configuration and must be removed from those references before deletion can proceed. Devices that already have the webclip installed are not immediately affected by deletion from the library — the webclip remains on those devices until actively removed via an operation or blueprint change.

**Key Fields**

webclipId (path) — Esper webclip UUID (required)

Response — The deleted Webclip record

**Common Use Cases**

Removing an outdated or incorrect webclip from the tenant library
Cleaning up test webclips created during development or blueprint configuration
Decommissioning a webclip for a retired internal web application

**Best Practices**

If you receive a 409, use GET /api/v2/webclips/{webclipId} to confirm which blueprints and blueprint versions reference the webclip, then remove those references before retrying the delete

Store the returned Webclip record from the 200 response for audit trail purposes

Note that deletion removes the webclip from the console but does not uninstall it from devices where it is already deployed — use an uninstall operation for that

## Path parameters

- `webclipId` string, uuid, required

## Response `200`

Success

- object
  - `content` AppsManagementWebclip
    - `id` string, uuid — Unique identifier for the web clip
    - `tenant_id` string, uuid — Tenant identifier
    - `label` string — Label of the web clip
    - `url` string, uri — URL associated with the web clip
    - `icon_url` string, uri, nullable — URL for the icon of the web clip
    - `target_bundle_name` string — Name of the target bundle
    - `target_bundle_id` string — ID of the target bundle
    - `is_full_screen` boolean — Indicates if the web clip is full screen
    - `is_removable` boolean — Indicates if the web clip is removable
    - `created_at` string, date-time — Timestamp of when the web clip was created
    - `updated_at` string, date-time — Timestamp of when the web clip was last updated
    - `created_by` string — The user who created the web clip
    - `updated_by` string — The user who last updated the web clip

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `409` — Conflict
- `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)