Update unpublished pin
update_pinDestructiveIdempotent
Edit a pin that has NOT been published yet: title, description, link, alt text or board.
Use to fix a typo, link or board before the pin publishes: queued,
deferred and failed pins then publish with the new values. Published
pins cannot be edited: Pinterest's API does not allow PinBridge to
change a pin once it is live, so the call fails with
pin_already_published. For a published pin, offer delete_pin plus a
new create_pin (confirm first). To change the image use delete_pin then
create_pin; for a failed pin on a bad board use retry_pin. Pass at
least one field.
Returns the updated pin. Fails with pin_already_published for a
published pin, not_found for an unknown id, and conflict
(pin_publishing) while the pin is mid-publish. A new board is
preflighted like create_pin.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | No | Pin title, at most 100 characters. | |
| pin_id | Yes | UUID of the pin, from list_pins or create_pin. | |
| alt_text | No | New accessibility text, <= 500 characters. | |
| board_id | No | Pinterest board ID (numeric string), from list_boards. | |
| link_url | No | Destination URL opened when the pin is clicked. | |
| description | No | Pin description, at most 800 characters. |