Grant workspace permissions to users or teams
This endpoint allows creating a grant which specifies permissions for one or more users or teams to access a workspace.
### Usage notes
- **Grants**: An array of grant objects. Each object specifies a grantee and the permission level assigned to them.
- Retrieve the **workspaceId** by calling the [/v2/workspaces](https://help.sigmacomputing.com/reference/list-workspaces) endpoint.
- Do not set both **memberId** and **teamId** in the same **grantee** object. Instead, choose one based on the target of the grant.
- Retrieve the **memberId** by calling the [/v2/members](https://help.sigmacomputing.com/reference/list-members) endpoint.
- Retrieve the **teamId** by calling the [/v2/teams](https://help.sigmacomputing.com/reference/list-teams) endpoint.
### Usage scenarios
- **Access control setup**: Use this endpoint to set up or modify access controls for a workspace, specifying which users or teams can access and what actions they can perform.
### Best practices
- **Clear permission definitions**: Ensure that the permissions granted are well understood by both the grantor and the grantee to avoid misuse of access rights.
Authentication
AuthorizationBearer
OAuth authentication of the form <token>.
Path parameters
workspaceId
Request
The request body.
grants
Response
The response body.

