Update API \ Delete a pin on Pinterest PHP SDK

Resource/URI PUT DELETE
Facebook · Page Post /update/identities/<identity_token>/facebook/page/<pageid>/post/<postid>.json Update Page Post Delete Page Post
Facebook · Page Picture /update/identities/<identity_token>/facebook/page/<pageid>/picture/<pictureid>.json - Delete Page Picture
Facebook · Page Video /update/identities/<identity_token>/facebook/page/<pageid>/video/<videoid>.json - Delete Page Video
Pinterest · Pin /update/identities/<identity_token>/pinterest/pin/<pinid>.json Delete Pin
Twitter · Tweet /update/identities/<identity_token>/twitter/post/<postid>.json - Delete Tweet
YouTube · Channel Section /update/identities/<identity_token>/youtube/channel/section/<channel_sectionid>.json Update Channel Section Delete Channel Section
YouTube · Playlist /update/identities/<identity_token>/youtube/playlist/<playlistid>.json Update Playlist Delete Playlist
YouTube · Playlist Video /update/identities/<identity_token>/youtube/playlist/<playlistid>/video/<videoid>.json - Delete Playlist Video

Workflow

Request: the code to send to the API

Send an API request to the following endpoint in order to delete a pin posted on a Pinterest board:

DELETE /update/identities/<identity_token>/pinterest/pin/<pin_id>.json

The <identity_token> is obtained whenever one of your users connects using his Pinterest account. The <pin_id> must correspond to the identifier of a pin published using our API and/or owned by the same user.

To be able to use this endpoint, Pinterest must be fully configured for your OneAll Site. The option Publish Actions must be enabled and the user must have given consent to publish content on his behalf when he logged in with Pinterest.

Result: the code returned by the API

The API either returns a HTTP status code 200 if the Pin was deleted successfully or an appropriate message body with further details on the error that occured.

Response Example

{
  "response": {
    "request": {
      "date": "Thu, 31 Oct 2019 18:25:03 +0100",
      "resource": "/update/identities/2af20011-8965-471b-8f6b-8b66a611aae6/pinterest/pin/352969689539596893.json",
      "status": {
        "flag": "success",
        "code": 200,
        "info": "The pin has successfully been removed."
      }
    }
  }
}

User Contributed Notes