---
title: "List a node's direct access grants"
method: GET
path: "/api/v1/nodes/{nodeId}/principals"
tags: ["Nodes", "Permissions"]
---

# List a node's direct access grants

`GET /api/v1/nodes/{nodeId}/principals`

## Request

- Base URL: `https://api-docs.busabase.com`
- URL: `https://api-docs.busabase.com/api/v1/nodes/{nodeId}/principals`
- Auth: none declared

## Path parameters

- `nodeId` string, required

## Response `200`

Direct grants defined ON this node (inherited copies from ancestor folders are not listed). Requires the node to be visible to the caller.

- object[]
  - `id` string, required
  - `nodeId` string, required
  - `principalType` 'user' | 'team' | 'space', required
  - `principalId` string, required
  - `role` 'read' | 'changeRequest' | 'write' | 'manage', required
  - `grantedBy` string, required
  - `createdAt` string, required
  - `updatedAt` string, required

---

[API](https://skmtc.dev/busabase/apis/busabase-api.md) · [All operations](https://skmtc.dev/busabase/apis/busabase-api/llms.txt) · [OpenAPI document](https://skmtc.dev/busabase/apis/busabase-api/revisions/bc6a7d5ff4c1?raw)