Skip to main content
DELETE
https://api.bouncy.ai
/
v1
/
links
/
bulk
curl -X DELETE https://api.bouncy.ai/v1/links/bulk \
  -H "X-Api-Key: bcy_live_pk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "linkIds": ["link_abc123", "link_def456", "link_ghi789"]
  }'

{
  "deleted": ["link_abc123", "link_def456"],
  "failed": [
    {
      "linkId": "link_ghi789",
      "error": {
        "code": "link_not_found",
        "message": "Link not found"
      }
    }
  ],
  "summary": {
    "total": 3,
    "succeeded": 2,
    "failed": 1
  }
}

​
Request

​
Headers

​
X-Api-Key
string
required
Your API key (e.g., bcy_live_pk_YOUR_API_KEY)
​
Content-Type
string
required
Must be application/json

​
Body

​
linkIds
array
required
Array of link IDs to delete (max: 100)Example: ["link_abc123", "link_def456", "link_ghi789"]
This action is permanent and cannot be undone. All short URLs will immediately stop working.

​
Response

​
deleted
array
Array of successfully deleted link IDs
​
failed
array
Array of failed deletion attempts with error details
​
summary
object
Summary counts
curl -X DELETE https://api.bouncy.ai/v1/links/bulk \
  -H "X-Api-Key: bcy_live_pk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "linkIds": ["link_abc123", "link_def456", "link_ghi789"]
  }'

{
  "deleted": ["link_abc123", "link_def456"],
  "failed": [
    {
      "linkId": "link_ghi789",
      "error": {
        "code": "link_not_found",
        "message": "Link not found"
      }
    }
  ],
  "summary": {
    "total": 3,
    "succeeded": 2,
    "failed": 1
  }
}