---
title: "Remove Share Asset"
method: POST
path: "/asset/{asset_id}/share/remove"
---

# Remove Share Asset

`POST /asset/{asset_id}/share/remove`

## Request

- Base URL: `https://api.tellers.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tellers.ai/asset/{asset_id}/share/remove`
- Auth: none declared

Remove one share (SSE): remove all access for either a group (group_id) or a user (email).
Caller must be able to share the asset; below ADMIN, only for shares no higher than their own
right and without can_share. If asset is a folder, applies to folder and underlying assets.

## Path parameters

- `asset_id` string, uuid, required

## Headers

- `x-api-key` string, nullable
- `authorization` string, nullable

## Request body

- ShareRemoveRequest: Remove one share: provide exactly one of group_id or email (removes all rights for that group/email).
  - `group_id` string, uuid, nullable
  - `email` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tellers/apis/tellers-api.md) - [All operations](https://skmtc.dev/tellers/apis/tellers-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tellers/apis/tellers-api/revisions/fdaa0fa44a26?raw)