Delete Pinboard

Delete a pinboard permanently.

Endpoint


DELETE /v1/pinboards/:boardId

Authentication

Requires API key with pinboards:write scope.

Example

Client-JS


import { PindownClient } from '@pindownai/client-js'
 
const client = new PindownClient({
  apiKey: process.env.PINDOWN_API_KEY
})
 
// Delete pinboard
try {
  await client.pinboards.delete('pb-abc123')
  console.log('Pinboard deleted successfully')
} catch (error) {
  console.error('Failed to delete pinboard:', error.message)
}

cURL


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

Node.js Fetch


const response = await fetch('https://api.pindown.ai/v1/pinboards/pb-abc123', {
  method: 'DELETE',
  headers: {
    'Authorization': `Bearer ${process.env.PINDOWN_API_KEY}`
  }
})
 
if (response.ok) {
  console.log('Pinboard deleted successfully')
}

Response


{
  "success": true
}

⚠️ Warning: This is permanent and cannot be undone. All pins will be removed from the pinboard (but not deleted).

Rate Limiting

This endpoint costs 2 tokens per request.