Group API
Grant Group Workspace Access
Grant one workspace viewer access to an existing group so it can use the group for assignment. Preserves all existing access, managers and members. Repeating a grant is a no-op; organization-wide groups remain organization-wide. Requires management of the group and destination workspace, in the same organization.
POST
Grant Group Workspace Access
Authentication and permissions
Token requirements: User-based token (OAuth) or Workspace-scoped API key. Send a bearer access token for one of these identities. The permissions and resource restrictions below also apply.
Permissions joined by + are all required; or separates alternatives. Full-access keys still cannot call endpoints marked unsupported. Workspace keys must allow every workspace checked by the request. OAuth access depends on the user’s roles and resource access.
- Grant workspace access as a user: Requires permission to manage the group and the destination workspace’s groups. The group and destination workspace must belong to the same organization. Existing managers, viewers and members are preserved. An already usable group is unchanged, including organization-wide groups.
- Grant workspace access with a workspace key: Requires groups:manage and a workspace-scoped key allowing a manager workspace and the destination workspace. Organization-scoped keys cannot perform this operation. The destination must be a live, non-personal workspace in the same organization. Groups that grant a workspace role cannot be changed with a workspace key. Synced groups can be shared without changing their source-owned members. Existing configuration-protection checks apply.

