Skip to content

Remove a board node

Take a tool off a board.

On this page

Removes one node from a board. The tool itself is untouched, and so is every other board holding it.

DELETEhttps://api2.rundiffusion.com/api/v2/boards/{board_id}/nodes/{node_id}
AcceptsOAuth device flowPersonal API Access TokenCompany API Access Token

Removing a node needs edit access to the board, described under Who can edit a board. Unlike deleting the board itself, it takes nothing extra.

Request

Headers

AuthorizationstringRequired
Bearer token. This endpoint accepts an OAuth device flow token, a Personal API Access Token, or a Company API Access Token. See Authentication.Authorization: Bearer eyJhbGciOi…

Path parameters

board_idstringRequired
The board the node is on.Tq8vNc…
node_idstringRequired
The node to remove, from Get a board.Nd4kWs…
curl -X DELETE https://api2.rundiffusion.com/api/v2/boards/$BOARD_ID/nodes/$NODE_ID \
  -H "Authorization: Bearer $RUNDIFFUSION_TOKEN"

Response

204 No Content. The remaining nodes close up: remove the first of three and the other two read 0 and 1 on the next fetch, with no gap where it was.

Nothing generated on that node is deleted; those stay in Library.

Errors

Status codes

401TOKEN_INVALID
Missing or invalid credential.
403PERMISSION_DENIED
You can see the board but may not change what is on it.
404BOARD_NOT_FOUND
No such board, or not one this credential can see.
404NODE_NOT_FOUND
No such node on that board, or it was already removed.
429RATE_LIMITED
Too many requests. Board writes have a tighter budget than reads. See Rate limits.

View as Markdown