> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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**:

```json theme={"dark"}
{
  "board_id": "549755885175",
  "name": "Autumn recipes 2026",
  "privacy": "PUBLIC",
  "updated": [
    "name"
  ]
}
```