Revoke a grant

DELETE/v1/grants/{id}

Revokes the grant (the principal loses any access it conferred).

Requires an API key (bearer), scoped to the active org. Supports idempotency keys.

Path parameters

idstringrequired

Returns

200The revocation confirmation.

Failures use the standard error envelope with a closed set of codes.

Terminal

renza grants revoke grt_5d2a…

DELETE /v1/grants/{id}

curl https://api.renza.io/v1/grants/grt_5d2a… \
  -H "Authorization: Bearer $RENZA_API_KEY" \
  -X DELETE

TypeScript

import { createRenzaClient } from "renza-sdk";

const renza = createRenzaClient({ apiKey: process.env.RENZA_API_KEY! });

const grant = await renza.grants.revoke("grt_5d2a…");

Response 200

{
  "object": "grant",
  "deleted": true
}