Update Pin - Markifact

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:

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