Delete a report grant

View as Markdown
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.

Authentication

AuthorizationBearer

OAuth authentication of the form <token>.

Path parameters

reportIdstringRequired
grantIdstringRequired

Response

The response body.