Delete post

DELETE

/v1/accounts/{accountId}/posts/{postId}

• Production
• Development

Delete a post. Only works for posts that haven’t been sent yet (draft or queued). Cannot delete posts that have already been published to Pinterest.

Authorizations

• bearerAuth

Parameters

Path Parameters

accountId

required

string

Pinterest account ID

postId

required

string

Post ID

Responses

200

Post deleted

object

data

object

deleted

boolean

true

meta

object

requestId

Unique request ID for debugging

string

400

Invalid request

object

error

object

code

Error code

string

message

Error message

string

meta

object

requestId

Unique request ID for debugging

string

Example

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Invalid request body"
  },
  "meta": {
    "requestId": "abc123"
  }
}

401

Authentication required or invalid API key

object

error

object

code

Error code

string

message

Error message

string

meta

object

requestId

Unique request ID for debugging

string

Example

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid API key"
  },
  "meta": {
    "requestId": "abc123"
  }
}

404

Resource not found

object

error

object

code

Error code

string

message

Error message

string

meta

object

requestId

Unique request ID for debugging

string

Example

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Account not found"
  },
  "meta": {
    "requestId": "abc123"
  }
}