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

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