Grant (or update) a principal's access level on a node

post/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

nodeIdstring required

Request body

principalType'user' | 'space' required

principalIdstring required

role'read' | 'changeRequest' | 'write' | 'manage' required

Response

Upserted one direct grant (same principal twice updates its level) and re-materialized inherited copies down the subtree. Requires manage level on the node.

grantedboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.