> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.
# List group shares
> This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.
Returns the workspace groups the app is shared with.
Every member of a shared group can use the app. A member's role in the app is the highest of the role you gave them directly and the roles of all the groups they're in that the app is shared with. Change a group's role with [Update group share](/api-reference/update-group-share), or stop sharing with [Remove group share](/api-reference/remove-group-share).
The response lists every share at once, with no paging. You need editor access to the app, and an editor or admin role in the app's workspace.
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.
## OpenAPI
````yaml /developers/references/app-management/app-management-openapi.json get /api/apps/{app_id}/group-shares
openapi: 3.1.0
info:
title: Base44 App Management API
version: 1.0.0
servers:
- url: https://app.base44.com
security:
- PersonalAccessTokenAuth: []
paths:
/api/apps/{app_id}/group-shares:
get:
summary: List group shares
description: >-
This API is in beta. Endpoints, fields, and behavior may still
change, so avoid depending on it in production.
Returns the workspace groups the app is shared with.
Every member of a shared group can use the app. A member's role in the
app is the highest of the role you gave them directly and the roles of
all the groups they're in that the app is shared with. Change a group's
role with [Update group share](/api-reference/update-group-share), or
stop sharing with [Remove group
share](/api-reference/remove-group-share).
The response lists every share at once, with no paging. You need editor
access to the app, and an editor or admin role in the app's workspace.
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.
operationId: list_shares_api_apps__app_id__group_shares_get
parameters:
- name: app_id
in: path
required: true
schema:
type: string
description: ID of the app.
title: App Id
description: ID of the app.
example: 6820f3a4e7b91d003c45a1f2
responses:
'200':
description: The app's group shares.
content:
application/json:
schema:
$ref: '#/components/schemas/ShareListResponse'
'401':
description: Missing or invalid credentials.
'403':
description: >-
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':
description: App not found.
components:
schemas:
ShareListResponse:
properties:
shares:
items:
$ref: '#/components/schemas/ShareSummary'
type: array
title: Shares
description: The app's group shares.
example:
- created_by: jane@acme.com
created_date: '2026-09-14T09:21:37.512000'
group_id: 68c9a0f1d2e4b5001f3a7c90
group_name: Sales team
group_source: custom
id: 68d1c2e4a9b7f3001e5c8a41
member_count: 12
role: user
unresolved_count: 0
type: object
required:
- shares
title: ShareListResponse
ShareSummary:
properties:
id:
type: string
title: Id
description: >-
ID of the share. Pass it as `share_id` to update or remove the
share.
example: 68d1c2e4a9b7f3001e5c8a41
group_id:
type: string
title: Group Id
description: ID of the workspace group the app is shared with.
example: 68c9a0f1d2e4b5001f3a7c90
group_name:
anyOf:
- type: string
- type: 'null'
title: Group Name
description: >-
Name of the group, or `null` when the group was deleted. A share
whose group was deleted grants no access, and you can still remove
it.
example: Sales team
group_source:
anyOf:
- type: string
- type: 'null'
title: Group Source
description: >-
Where the group comes from: `custom` for a group created in Base44,
or `idp` for a group your identity provider syncs over SCIM. `null`
when the group was deleted.
example: custom
member_count:
type: integer
title: Member Count
description: Number of group members with a Base44 account.
default: 0
example: 12
unresolved_count:
type: integer
title: Unresolved Count
description: >-
Number of group members your identity provider synced who don't have
a Base44 account yet. They get access once they have one.
default: 0
example: 0
role:
anyOf:
- type: string
- type: 'null'
title: Role
description: >-
App role the share gives the group's members, or `null` when it
assigns none and members get the default `user` role.
example: user
created_by:
anyOf:
- type: string
- type: 'null'
title: Created By
description: Email of the person who shared the app with the group.
example: jane@acme.com
created_date:
anyOf:
- type: string
- type: 'null'
title: Created Date
description: >-
When the app was shared with the group, in UTC, as ISO 8601 without
a timezone suffix.
example: '2026-09-14T09:21:37.512000'
type: object
required:
- id
- group_id
- group_name
- group_source
- member_count
- unresolved_count
- role
- created_by
- created_date
title: ShareSummary
securitySchemes:
PersonalAccessTokenAuth:
type: http
scheme: bearer
description: 'Personal access token, sent as `Authorization: Bearer `.'
````