Remove Pin from Page

Remove a pin from a page. The pin is not deleted, only removed from the page.

Endpoint


DELETE /v1/pages/:pageId/pins/:pinId

Authentication

Requires API key with pages:write scope. You must be the page owner or an editor.


Authorization: Bearer pk_live_your_api_key

Path Parameters

Parameter	Type	Required	Description
`pageId`	string	Yes	Page ID (e.g., `pg-abc123`)
`pinId`	string	Yes	Pin ID to remove (e.g., `p-xyz789`)

Example

Client-JS


import { PindownClient } from '@pindownai/client-js'
 
const client = new PindownClient({
  apiKey: process.env.PINDOWN_API_KEY
})
 
await client.pages.removePin('pg-abc123', 'p-xyz789')
 
console.log('Pin removed from page')

cURL


curl -X DELETE https://api.pindown.ai/v1/pages/pg-abc123/pins/p-xyz789 \
  -H "Authorization: Bearer pk_live_your_api_key"

Node.js Fetch


await fetch('https://api.pindown.ai/v1/pages/pg-abc123/pins/p-xyz789', {
  method: 'DELETE',
  headers: {
    'Authorization': `Bearer ${process.env.PINDOWN_API_KEY}`
  }
})
 
console.log('Pin removed from page')

Response


{
  "success": true,
  "message": "Pin removed from page successfully"
}

Notes

The pin is not deleted, only removed from the page
The pin can still be accessed individually or added to other pages
Removing a pin does not affect other pages that contain the same pin

Next Steps

List Pins in Page - See remaining pins
Add Pin to Page - Add pins back to the page