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

# Update group share

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



## OpenAPI

````yaml /developers/references/app-management/app-management-openapi.json put /api/apps/{app_id}/group-shares/{share_id}
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/{share_id}:
    put:
      summary: Update group share
      description: >-
        <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>
      operationId: update_share_api_apps__app_id__group_shares__share_id__put
      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
        - name: share_id
          in: path
          required: true
          schema:
            type: string
            description: >-
              ID of the share, as `id` in the response of [List group
              shares](/api-reference/list-group-shares).
            title: Share Id
          description: >-
            ID of the share, as `id` in the response of [List group
            shares](/api-reference/list-group-shares).
          example: 68d1c2e4a9b7f3001e5c8a41
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateShareRequest'
      responses:
        '200':
          description: The share with its new role.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdateShareResponse'
        '401':
          description: Missing or invalid credentials.
        '402':
          description: Your workspace's plan doesn't include workspace groups.
        '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 or share not found.
        '422':
          description: '`role` isn''t one of the roles defined on the app''s User entity.'
components:
  schemas:
    UpdateShareRequest:
      properties:
        role:
          anyOf:
            - type: string
            - type: 'null'
          title: Role
          description: >-
            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.
          example: admin
      type: object
      title: UpdateShareRequest
    UpdateShareResponse:
      properties:
        id:
          type: string
          title: Id
          description: ID of the share.
          example: 68d1c2e4a9b7f3001e5c8a41
        role:
          anyOf:
            - type: string
            - type: 'null'
          title: Role
          description: >-
            App role the share now gives the group's members, or `null` when it
            assigns none.
          example: admin
      type: object
      required:
        - id
        - role
      title: UpdateShareResponse
  securitySchemes:
    PersonalAccessTokenAuth:
      type: http
      scheme: bearer
      description: 'Personal access token, sent as `Authorization: Bearer <token>`.'

````