---
title: "Delete a report grant"
method: DELETE
path: "/v2/reports/{reportId}/grants/{grantId}"
tags: ["Reports"]
---

# Delete a report grant

`DELETE /v2/reports/{reportId}/grants/{grantId}`

## Request

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

This endpoint deletes a specific grant from a report. 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
  - **reportId:** The identifier of the report from which the grant is to be deleted. Retrieve the **reportId** by calling the [/v2/reports](https://help.sigmacomputing.com/reference/list-reports) 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 `reportId` 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 reports 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 report 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

- `reportId` string, required
- `grantId` string, required

## Response `200`

The response body.

- ReportsDeleteReportGrantResponse200

---

[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)