Skip to Content
Pindown.ai is in early alpha - features may change
Pins APIDelete Pin

Delete Pin

Delete a pin permanently.

Endpoint

DELETE /v1/pins/:pinId

Authentication

Requires API key with pins:write scope.

Authorization: Bearer pk_live_your_api_key

Path Parameters

ParameterTypeRequiredDescription
pinIdstringYesThe pin ID (e.g., p-abc123def456)

Response

Success (200 OK)

{ "success": true, "data": { "deleted_at": 1730479200000 } }

Example

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