Update Pin

PATCH {{baseUrl}}/pins/:pin_id?ad_account_id=47

Update a pin owned by the operating user_account. - By default, the operation user_account is the token user_account.

Optional: Business Access: Specify an adaccountid (obtained via List ad accounts) to use the owner of that adaccount as the "operation useraccount. In order to do this, the token user_account must have one of the following https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access roles on the ad_account:

• For Pins on public or protected boards: Owner, Admin, Analyst, Campaign Manager.
• For Pins on secret boards: Owner, Admin.

This endpoint is currently in beta and not available to all apps. Learn more.

Request Params

Request Body

{"alt_text"=>"<string>", "board_id"=>"6319566212", "board_section_id"=>"96451", "description"=>"<string>", "link"=>"<string>", "title"=>"<string>", "carousel_slots"=>[{"title"=>"<string>", "description"=>"<string>", "link"=>"<string>"}, {"title"=>"<string>", "description"=>"<string>", "link"=>"<string>"}], "note"=>"<string>"}

HEADERS

RESPONSES

status: OK

{"id":"82451768076","created_at":"\u003cdateTime\u003e","link":"\u003cstring\u003e","title":"\u003cstring\u003e","description":"\u003cstring\u003e","dominant_color":"\u003cstring\u003e","alt_text":"\u003cstring\u003e","creative_type":"QUIZ","board_id":"24746","board_section_id":"3","board_owner":{"username":"\u003cstring\u003e"},"is_owner":"\u003cboolean\u003e","media":{"media_type":"\u003cstring\u003e"},"media_source":{"source_type":"image_base64","content_type":"image/png","data":"kgyHJEtc","is_standard":true},"parent_pin_id":"927531","is_standard":"\u003cboolean\u003e","has_been_promoted":"\u003cboolean\u003e","note":"\u003cstring\u003e"}