Skip to main content
Glama

Update unpublished pin

update_pin
DestructiveIdempotent

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
NameRequiredDescriptionDefault
titleNoPin title, at most 100 characters.
pin_idYesUUID of the pin, from list_pins or create_pin.
alt_textNoNew accessibility text, <= 500 characters.
board_idNoPinterest board ID (numeric string), from list_boards.
link_urlNoDestination URL opened when the pin is clicked.
descriptionNoPin description, at most 800 characters.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed8 schema fields changed
    • addedInput schema / properties / alt_text / description
      Added value: +"New accessibility text, <= 500 characters."
    • addedInput schema / properties / board_id / description
      Added value: +"Pinterest board ID (numeric string), from list_boards."
    • changedInput schema / properties / description / anyOf
      Previous value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "maxLength": 800,
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedInput schema / properties / description / description
      Added value: +"Pin description, at most 800 characters."
    • addedInput schema / properties / link_url / description
      Added value: +"Destination URL opened when the pin is clicked."
    • addedInput schema / properties / pin_id / description
      Added value: +"UUID of the pin, from list_pins or create_pin."
    • changedInput schema / properties / title / anyOf
      Previous value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "maxLength": 100,
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedInput schema / properties / title / description
      Added value: +"Pin title, at most 100 characters."
  2. Added

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources