---
title: "Revoke a principal's access grant on a node"
method: DELETE
path: "/api/v1/nodes/{nodeId}/principals"
tags: ["Nodes", "Permissions"]
---

# Revoke a principal's access grant on a node

`DELETE /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

## Request body

- object
  - `principalType` 'user' | 'space', required
  - `principalId` string, required

## Response `200`

Removed the direct grant (and its materialized inherited copies). Requires `manage` level on the node.

- object
  - `removed` boolean, 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)