Update Board

Renames a board or updates its description or privacy

Renames a board or updates its description or privacy.

App	Pinterest Organic
Operation ID	pinterest_update_board
Type	Action
Connection	pinterest (required)
Credits per run	1
Agent / MCP tool	Yes
Requires approval	Yes (write operation)

Inputs

Field	Type	Required	Default	Description
board	string or SelectItem	Yes	-	The board to update. Accepts a board id, which pinterest_list_boards returns. Ask the user which board if it is not provided.
name	string	No	-	New board name, up to 180 characters. Leave empty to keep the current one.
description	string	No	-	New board description, up to 500 characters. Leave empty to keep the current one.
privacy	string or SelectableOption	No	-	New privacy for the board. Available options: ‘PUBLIC’ (anyone can see the board), ‘SECRET’ (only the account owner and the board’s collaborators can see it) or ‘PROTECTED’ (Pinterest’s ad only board type, kept off the public profile). Leave empty to keep the current one.

SelectItem

Field	Type	Required	Default	Description
value	string	Yes	-	The value of the selectable item.
label	string	Yes	-	The label of the selectable item, used for display purposes. If not provided, defaults to the value.

SelectableOption

Field	Type	Required	Default	Description
value	string	Yes	-
label	string	Yes	-

Output

Type: Dict

Returns the board’s id and settings along with the fields that were updated.

Fields: board_id, name, description, privacy, updated

Example:

{
  "board_id": "549755885175",
  "name": "Autumn recipes 2026",
  "privacy": "PUBLIC",
  "updated": [
    "name"
  ]
}