---
title: "Delete a workbook grant"
method: DELETE
path: "/v2/workbooks/{workbookId}/grants/{grantId}"
tags: ["Workbooks"]
---

# Delete a workbook grant

`DELETE /v2/workbooks/{workbookId}/grants/{grantId}`

## Request

- Base URL: `https://api.sigmacomputing.com`
- URL: `https://api.sigmacomputing.com/v2/workbooks/{workbookId}/grants/{grantId}`
- Auth: HTTP bearer

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.

## Path parameters

- `workbookId` string, required
- `grantId` string, required

## Response `200`

The response body.

- WorkbooksDeleteWorkbookGrantResponse200

---

[API](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api.md) - [All operations](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api/revisions/fb6036208c49?raw)