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
try {
const result = await client.pins.delete('p-abc123def456')
console.log(`Pin deleted at: ${result.deleted_at}`)
} 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 Limiting
This endpoint costs 2 tokens per request.
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