Delete Node
Deletes a node. Only an empty node can be deleted: a node that still has child nodes, supervisors or tokens is refused, each with its own code.
Required permission: node:delete
Request
DELETE /v2/admin/nodes/{node_id}
Parameters
| Name | Type | In | Description |
|---|---|---|---|
node_id | string | path | Required. The node's id |
Headers
| Name | Description |
|---|---|
Authorization | Required. Bearer <access_token> |
Example
curl --request DELETE \
--url '{{baseUrl}}/v2/admin/nodes/6a4bef2b1e781b11c22e9707' \
--header 'Authorization: Bearer <access_token>'
Response
200 OK with an empty body.
Errors
| Status | Code | Description |
|---|---|---|
| 400 | 10016 | node_id is not a valid id |
| 400 | 10001 | Node not found (node domain 2) |
| 400 | 10008 | The node has child nodes (node domain 2) |
| 400 | 10009 | The node has supervisors (node domain 2) |
| 400 | 10010 | The node has tokens (node domain 2) |
| 403 | 10005 | The node is outside your part of the hierarchy (node domain 2) |
See Errors for the error format and common codes.