---
title: "Get webclip by id for a tenant"
method: GET
path: "/v2/webclips/{webclipId}"
tags: ["apps_management_Webclips"]
---

# Get webclip by id for a tenant

`GET /v2/webclips/{webclipId}`

⚠️ iOS/iPadOS only.

Retrieves the full record for a specific webclip by its Esper UUID.
Returns a single Webclip object with all fields including label, URL, target bundle ID and name, full-screen mode, removability, icon URL, and audit timestamps.

**About Get Webclip**

This endpoint fetches the complete detail record for a single webclip, identified by its Esper-assigned UUID. It is the direct lookup complement to GET /api/v2/webclips — use it when you already have the webclipId and need to confirm current configuration or retrieve specific field values before an update or deployment operation. The response is identical in structure to webclip records returned by the list endpoint.

**Key Fields**

webclipId (path) — Esper webclip UUID (required)

label — Home screen display name

url — URL the webclip opens

target_bundle_id / target_bundle_name — iOS app handling the URL

is_full_screen / is_removable — Behavioral flags

icon_url — URL for the webclip's home screen icon (nullable)

**Common Use Cases**

Confirming webclip configuration details before including it in a blueprint

Retrieving current url or target bundle values for audit or documentation purposes

Pre-flight check before a DELETE to confirm the correct webclip is targeted

**Best Practices**

Use this as a pre-flight check before DELETE operations to confirm the correct webclipId is targeted

If the webclipId is unknown, use GET /api/v2/webclips with exact_esper_name to look it up first

## 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
- `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)