Retrieve a grant

GET/v1/grants/{id}

Fetches a single access grant by id within the active org.

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

Path parameters

idstringrequired

Returns

200The grant.

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

Terminal

renza grants get grt_5d2a…

GET /v1/grants/{id}

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

TypeScript

import { createRenzaClient } from "renza-sdk";

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

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

Response 200

{
  "id": "grt_5d2a…",
  "object": "grant",
  "principal_type": "user",
  "principal": "alice@acme.com",
  "resource_type": "deck",
  "resource": "deck_2a9f…",
  "role": "viewer",
  "created_at": "2026-06-19T10:30:00.000Z",
  "updated_at": "2026-06-19T10:30:00.000Z"
}