Skip to main content
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.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

Body

application/json
teamId
string
required

Response

200 - application/json

Success

data
data · object