Skip to navigation

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 endpoint.
  • grantId: The identifier of the grant that needs to be removed. Retrieve the grantId by calling the /v2/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
Unique identifier of the report.
grantIdstringRequired
Unique identifier of the grant.

Response

The response body.