Create or update a grant
Create a grant or update an existing grant on a document, folder, or workspace to a user or a team by ID.
### Usage notes
- This endpoint can only be used to escalate the level of access that a user has to a document. To remove or reduce a user's access to a specific document, call [/v2/grants/{grantId}](https://help.sigmacomputing.com/reference/delete-grant) to delete the existing grant and re-grant the desired level of access.
- 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.
- Retrieve the **inodeId** by calling the [/v2/files](https://help.sigmacomputing.com/reference/list-files) endpoint and using the `id` included in the response.
- Retrieve the **inodeId** for a data model by calling the [/v2/dataModels](https://help.sigmacomputing.com/reference/list-data-models) endpoint and using the `dataModelId` included in the response.
- Optionally specify a **tagId** to associate the permission with a specific version tag of a workbook, dataset (deprecated), or database table. Retrieve the **tagId** by calling the [/v2/tags](https://help.sigmacomputing.com/reference/list-version-tag) endpoint and using the `versionTagId` included in the response.
Authentication
AuthorizationBearer
OAuth authentication of the form <token>.
Request
The request body.
grantee
permission
inodeId
tagId
Response
The response body.
grantId
The unique identifier of the grant
inodeId
The unique identifier of the inode
organizationId
The unique identifier of the organization
memberId
The unique identifier of the member
teamId
The unique identifier of the team
permission
The permission granted to the member
createdBy
The identifier of the user who created this grant
updatedBy
The identifier of the user or process that last updated this grant
createdAt
When the grant was created
updatedAt
When the grant was last updated
inodeType

