Remove a board node
Take a tool off a board.
Removes one node from a board. The tool itself is untouched, and so is every other board holding it.
DELETE
https://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"await fetch(
`https://api2.rundiffusion.com/api/v2/boards/${boardId}/nodes/${nodeId}`,
{
method: 'DELETE',
headers: {
Authorization: `Bearer ${process.env.RUNDIFFUSION_TOKEN}`,
},
},
);requests.delete(
f"{BASE}/boards/{board_id}/nodes/{node_id}",
headers=HEADERS,
)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.
