Edit a board

Changes a board's own details. Changing what is on it starts with Add a board node, and who can reach it is Set board access settings: access_level is not editable here.

Who can edit a board#

Editing follows the app exactly. You may edit a board if any of these is true:

• you own it,
• you hold Can manage everyone's generations and boards (MANAGE_ALL_GENERATIONS),
• it is SHARED or RESTRICTED and you hold Can manage Shared assets (SHARE_ASSETS).

That last one is what lets a team curate shared boards without making everyone an owner. It does not extend to deleting: see Delete a board.

The same rule governs every write to a board's contents, so the node endpoints point back here rather than restating it.

Request#

Send only what you are changing. At least one field is required, so an empty body is a 400 rather than a silent no-op.

curl -X PATCH https://api2.rundiffusion.com/api/v2/boards/$BOARD_ID \
  -H "Authorization: Bearer $RUNDIFFUSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title": "Hero shots v2"}'

await fetch(`https://api2.rundiffusion.com/api/v2/boards/${boardId}`, {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.RUNDIFFUSION_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ title: 'Hero shots v2' }),
});

requests.patch(
    f"{BASE}/boards/{board_id}",
    headers=HEADERS,
    json={"title": "Hero shots v2"},
)

Response#

200 OK with the full board, nodes and members included, so a client that renders the board can use the response directly instead of refetching. The fields are the ones Get a board documents.

Errors#