Delete node definitions

POST

Marks one or more nodes as deleted for the authenticated environment.

Request body

{
  "nodeIds": [42, 43]
}

Body fields

Field	Type	Description
nodeIds	integer[]	One or more positive node IDs to delete

Response object

The response confirms that one or more nodes were marked as deleted.

Attributes

Field	Type	Description
message	string	Human-readable deletion result
deletedCount	integer	Number of nodes deleted
deletedAt	datetime	Timestamp when the delete completed

Returns

• A JSON object containing message, deletedCount, and deletedAt

Response

• 200 OK

{
  "message": "Successfully deleted 2 nodes",
  "deletedCount": 2,
  "deletedAt": "2026-03-23T12:00:00.000Z"
}

Errors

• 400: invalid JSON, invalid body, or one or more node IDs not found
• 401: unauthorized
• 403: forbidden