Delete Page

Delete a page permanently. Pins in the page are not deleted, only removed from the page.

Endpoint


DELETE /v1/pages/:pageId

Authentication

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


Authorization: Bearer pk_live_your_api_key

Path Parameters

Parameter	Type	Required	Description
`pageId`	string	Yes	Page ID (e.g., `pg-abc123`)

Example

Client-JS


import { PindownClient } from '@pindownai/client-js'
 
const client = new PindownClient({
  apiKey: process.env.PINDOWN_API_KEY
})
 
await client.pages.delete('pg-abc123')
 
console.log('Page deleted')

cURL


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

Node.js Fetch


await fetch('https://api.pindown.ai/v1/pages/pg-abc123', {
  method: 'DELETE',
  headers: {
    'Authorization': `Bearer ${process.env.PINDOWN_API_KEY}`
  }
})
 
console.log('Page deleted')

Response


{
  "success": true,
  "message": "Page deleted successfully"
}

Notes

Pins are not deleted when you delete a page
Pins are only removed from the page’s pin list
You can still access pins individually or add them to other pages

Next Steps

List Pages - View your remaining pages
Create Page - Create a new page