v44

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

Permissions

Check permissions

⚠️ This endpoint is in public preview.

Evaluate one or more "resource:verb" actions against the caller's grants and return a single aggregated verdict. Pass workspace to check workspace-scoped grants, or omit it to check org-scoped grants.

post/preview/v2/permissions/check

Request body

workspacestring

actionsstring[] required

One or more "resource:verb" actions (e.g. "node:read", "order:write") to evaluate. The response is a single aggregated verdict across the whole list.

Example request

{
  "workspace": "wksp_k3R-nX9vLm7Qp2Yw5Jd8F",
  "actions": [
    "node:read",
    "order:write"
  ]
}

Response

Permission evaluated.

allowedboolean required

Whether the caller can perform every action in the request directly without approval.