---
title: "Remove Custom Agent Share"
method: POST
path: "/agent/{custom_agent_id}/share/remove"
deprecated: true
---

# Remove Custom Agent Share

`POST /agent/{custom_agent_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/agent/{custom_agent_id}/share/remove`
- Auth: none declared

> **Deprecated.**

Stop sharing the assistant with a group or with one person.

Needs ``can_share`` on the assistant, except that anyone may remove their
own access; below ADMIN only a grant the caller could have made. Returns
the sharing left, empty when the caller removed their own.

## Path parameters

- `custom_agent_id` string, uuid, required

## Headers

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

## Request body

- CustomAgentShareRemoveRequest: Remove the grant to one group (``group_id``) or one person (``email``).
  - `group_id` string, uuid, nullable
  - `email` string, nullable

## Response `200`

Successful Response

- AssetShareResponseOptimized: Optimized share config: groups and validated_users with rights, plus flags. ``can_share`` is whether the caller may manage sharing: ADMIN, or a share with ``can_share``.
  - `groups` GroupShareInfo[]
    - `group_id` string, required
    - `group_name` string, required
    - `right` string, required
    - `can_share` boolean, nullable: Whether the group may share onward: ADMIN, or a share with can_share. Null for chats, which cannot be shared onward.
  - `validated_users` ValidatedUserInfo[]
    - `email` string, required
    - `right` string, required
    - `can_share` boolean, nullable: Whether the person may share onward: ADMIN, or a share with can_share. Null for chats, which cannot be shared onward.
  - `pending_invites` ValidatedUserInfo[]: Emails this was shared with before they had an account. Each becomes a validated user once someone signs in with it.
    - `email` string, required
    - `right` string, required
    - `can_share` boolean, nullable: Whether the person may share onward: ADMIN, or a share with can_share. Null for chats, which cannot be shared onward.
  - `is_public_read` boolean
  - `can_share` boolean

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