---
title: "Remove group share"
method: DELETE
path: "/api/apps/{app_id}/group-shares/{share_id}"
---

# Remove group share

`DELETE /api/apps/{app_id}/group-shares/{share_id}`

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Stops sharing the app with a group.

Members who can use the app only through this group lose access. Members with a direct role, or another shared group, keep access at the highest role they still have. If the call fails, the share is kept, so you can safely retry.

This works on any plan, so you can remove shares after your workspace's plan no longer includes groups. You need editor access to the app, and an editor or admin role in the app's workspace.

<Note>This endpoint accepts a personal API key belonging to a user with editor access to the app. A read-only key is refused, and workspace API keys are not accepted.</Note>

## Path parameters

- `app_id` string, required — ID of the app.
- `share_id` string, required — ID of the share, as `id` in the response of [List group shares](/api-reference/list-group-shares).

## Response `200`

The share was removed.

- OperationResponse
  - `success` boolean, required — Always `true`. A removal that doesn't happen returns an error instead.

## Other responses

- `401` — Missing or invalid credentials.
- `403` — You don't have editor access to this app, you aren't an editor or admin in the app's workspace, or your API key is read-only.
- `404` — App or share not found.

## Changes

> 18 revisions in range; 1 not diffed.

- **2026-09-28** `28fc82924122` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/adexad/apis/base44-app-management-api/changes/api/apps/:app_id/group-shares/:share_id/delete.md)

---

[API](https://skmtc.dev/adexad/apis/base44-app-management-api.md) · [All operations](https://skmtc.dev/adexad/apis/base44-app-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/adexad/apis/base44-app-management-api/revisions/28fc82924122?raw)