Batch Delete Pins

Delete multiple pins in a single request. This is more efficient than making individual DELETE requests.

Endpoint


DELETE /v1/pins/batch

Authentication

Requires API key with pins:write scope. You must be the owner of each pin.


Authorization: Bearer pk_live_your_api_key

Request Body

Field	Type	Required	Description
`pin_ids`	string[]	Yes	Array of pin IDs to delete (max 50)

Example

Client-JS


import { PindownClient } from '@pindownai/client-js'
 
const client = new PindownClient({
  apiKey: process.env.PINDOWN_API_KEY
})
 
const result = await client.pins.batchDelete([
  'p-abc123',
  'p-xyz789',
  'p-def456'
])
 
console.log(`Deleted: ${result.deleted.length}`)
console.log(`Failed: ${result.failed.length}`)

cURL


curl -X DELETE https://api.pindown.ai/v1/pins/batch \
  -H "Authorization: Bearer pk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "pin_ids": ["p-abc123", "p-xyz789", "p-def456"]
  }'

Node.js Fetch


const response = await fetch('https://api.pindown.ai/v1/pins/batch', {
  method: 'DELETE',
  headers: {
    'Authorization': `Bearer ${process.env.PINDOWN_API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    pin_ids: ['p-abc123', 'p-xyz789', 'p-def456']
  })
})
 
const result = await response.json()
console.log(`Deleted: ${result.data.deleted.length}`)

Response


{
  "success": true,
  "data": {
    "deleted": ["p-abc123", "p-xyz789"],
    "failed": [
      {
        "id": "p-def456",
        "error": "Permission denied"
      }
    ]
  },
  "message": "Deleted 2 pins"
}

Response Fields

deleted: Array of pin IDs that were successfully deleted
failed: Array of pins that failed to delete with error messages

Notes

Maximum 50 pins per batch request
Each pin is processed independently - if one fails, others still succeed
You must be the owner of each pin to delete it (editors cannot delete)
Deleting a pin also removes it from all pinboards and pages
This operation is irreversible

Next Steps

Batch Get Pins - Retrieve multiple pins
Batch Create Pins - Create multiple pins
Delete Pin - Delete a single pin