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

# Update group share

`PUT /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>

Changes the app role a group share gives the group's members.

Send the whole new value. Leaving `role` out, or sending `null`, stops assigning a role, so members get the default `user` role. Lowering a group's role doesn't lower a member who has a higher role directly or through another shared group. Members' access usually updates right away, and always by their next sign-in. Sending the role the share already has changes nothing.

You need editor access to the app, and an editor or admin role in the app's workspace. Your workspace's plan must include workspace groups.

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

## Request body

- UpdateShareRequest
  - `role` string, nullable — App role the group's members get, one of the roles defined on the app's User entity. Send `null`, or leave `role` out, to stop assigning a role, so members get the default `user` role.

## Response `200`

The share with its new role.

- UpdateShareResponse
  - `id` string, required — ID of the share.
  - `role` string, nullable, required — App role the share now gives the group's members, or `null` when it assigns none.

## Other responses

- `401` — Missing or invalid credentials.
- `402` — Your workspace's plan doesn't include workspace groups.
- `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.
- `422` — `role` isn't one of the roles defined on the app's User entity.

## Changes

- **2026-09-27** `5e69adeb8667` — 1 info
  - endpoint added

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

---

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