Sign in

v44

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-20129390589.6 KB
Grants

Get grant

⚠️ This endpoint is in public preview.

Retrieve a grant by ID. Callers without grant:read may still fetch a grant whose principal is themselves

get/preview/v2/grants/{id}

Path parameters

idstring required
Example:grnt_k3R-nX9vLm7Qp2Yw5Jd8F

Grant ID

Response

Grant found.

OR

Example response

{
  "principal_id": "my-resource-name",
  "object": "grant",
  "id": "grnt_k3R-nX9vLm7Qp2Yw5Jd8F",
  "workspace": {
    "id": "wksp_k3R-nX9vLm7Qp2Yw5Jd8F",
    "name": "my-resource-name"
  },
  "role": {
    "id": "role_k3R-nX9vLm7Qp2Yw5Jd8F",
    "name": "my-resource-name"
  },
  "created_at": 1738972800
}