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

Shares the app with one or more workspace groups, giving every member of each group access to the app.

All the groups get the same role. 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. Members usually get access right away, and always by their next sign-in. Members your identity provider synced who don't have a Base44 account yet get access once they have one. Each member who gets access is also sent an invitation email, at most once per app.

Each group succeeds or fails on its own, so read results rather than treating a successful response as every group shared. Sending a group the app is already shared with fails that group with already_shared and changes nothing, so retrying is safe. Change a share's role afterwards with Update group share.

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.

This is limited to 30 requests per minute. A signed-in session has its own limit, and every personal access token for the workspace shares one. Some workspaces have a different limit.

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

{
  "group_ids": [
    "68c9a0f1d2e4b5001f3a7c90"
  ],
  "role": "user"
}

{
  "results": [
    {
      "group_id": "68c9a0f1d2e4b5001f3a7c90",
      "success": true
    }
  ]
}