Delete Pin
Delete a pin permanently.
Endpoint
DELETE /v1/pins/:pinIdAuthentication
Requires API key with pins:write scope.
Authorization: Bearer pk_live_your_api_keyPath Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
pinId | string | Yes | The pin ID (e.g., p-abc123def456) |
Response
Success (200 OK)
{
"success": true,
"data": {
"deleted_at": 1730479200000
}
}Example
Client-JS
import { PindownClient } from '@pindownai/client-js'
const client = new PindownClient({
apiKey: process.env.PINDOWN_API_KEY
})
// Delete a pin (returns void on success)
try {
await client.pins.delete('p-abc123def456')
console.log('Pin deleted successfully')
} catch (error) {
console.error('Failed to delete pin:', error.message)
}Error Responses
404 Not Found
{
"error": {
"code": "NOT_FOUND",
"message": "Pin not found or you don't have access"
}
}403 Forbidden
{
"error": {
"code": "FORBIDDEN",
"message": "You don't have permission to delete this pin"
}
}401 Unauthorized
{
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid or missing API key"
}
}Rate limits
Write bucket: 90 requests / 60 seconds. See Overview → Rate limits.
Important Notes
⚠️ Warning: Deleting a pin is permanent and cannot be undone. The pin will be removed from:
- All pinboards it belongs to
- Public share URLs (if public)
- Your pin list
Make sure you really want to delete the pin before calling this endpoint.
Next Steps
- Create Pin - Create a new pin
- List Pins - Get all your pins
- Get Pin - Retrieve pin details