Delete a workbook grant

View as MarkdownOpen in Claude
This endpoint deletes a specific grant from a workbook. Deleting a grant revokes the permissions associated with it, ensuring that the specified users or teams no longer have the access rights previously granted. ### Usage notes - **workbookId:** The identifier of the workbook from which the grant is to be deleted. Retrieve the **workbookId** by calling the [/v2/workbooks](https://help.sigmacomputing.com/reference/list-workbooks) endpoint. - **grantId:** The identifier of the grant that needs to be removed. Retrieve the **grantId** by calling the [/v2/grants](https://help.sigmacomputing.com/reference/list-grants) endpoint with the `workbookId` as the `inodeId`. ### Usage scenarios - **Access revocation:** Administrators can use this endpoint to manage and revoke access as team roles or project needs evolve. - **Security compliance:** Ensures that access to sensitive data within workbooks is tightly controlled and can be promptly adjusted in response to security policy changes or personnel updates. ### Best practices - Always confirm the identities associated with both the workbook and grant before proceeding with deletion to avoid accidental revocations. - Log and audit all grant deletions to maintain records for security audits and compliance tracking.

Authentication

AuthorizationBearer

OAuth authentication of the form <token>.

Path parameters

workbookIdstringRequired
grantIdstringRequired

Response

The response body.