> ## 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 Pin

> Updates an existing pin's title, description, destination link, or alt text, or moves it to another board or board section

Updates an existing pin's title, description, destination link, or alt text, or moves it to another board or board section. Pinterest cannot change a pin's image or video after it is published.

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

## Inputs

| Field           | Type                 | Required | Default | Description                                                                                                                                                     |
| --------------- | -------------------- | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `pin_id`        | string               | Yes      | -       | The id of the pin to update, which pinterest\_list\_pins and pinterest\_publish\_pin return. The pin's image or video cannot be changed, only the fields below. |
| `title`         | string               | No       | -       | New pin title, up to 100 characters. Leave empty to keep the current one.                                                                                       |
| `description`   | string               | No       | -       | New pin description, up to 800 characters. Leave empty to keep the current one.                                                                                 |
| `alt_text`      | string               | No       | -       | New description of the image for screen readers, up to 500 characters. Leave empty to keep the current one.                                                     |
| `link`          | string               | No       | -       | New destination URL the pin sends people to when clicked. Leave empty to keep the current one.                                                                  |
| `board`         | string or SelectItem | No       | -       | Board id to move the pin to, which pinterest\_list\_boards returns. Leave empty to keep the pin on its current board.                                           |
| `board_section` | string               | No       | -       | Board section id to file the pin under. Set board as well, since a section id is only valid within its own board.                                               |

### 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. |

## Output

**Type**: `Dict`

Returns the pin's id and URL along with the fields that were updated.

**Fields**: `pin_id`, `pin_url`, `board_id`, `title`, `updated`

**Example**:

```json theme={"dark"}
{
  "pin_id": "813744226420795884",
  "pin_url": "https://www.pinterest.com/pin/813744226420795884/",
  "title": "Autumn recipes",
  "updated": [
    "title",
    "link"
  ]
}
```