> ## 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 |
| - | - | - | - | - |
| `ad_account_id` | integer or string | No | - | Optional, for brand profiles reached through Pinterest Business Access. The id of an ad account owned by that brand profile, e.g. '549769672300'. When set, the operation acts on the profile that owns this ad account instead of the signed-in profile. Ad account ids and their owning profile (ownerUsername) come from pinterest\_ads\_select\_accounts. A profile that owns no ad account cannot be reached this way. Leave empty for the signed-in profile. |
| `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"
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.