Skip to main content
DELETE
/
v1
/
links
/
bulk
curl -X DELETE https://api.bouncy.ai/v1/links/bulk \
  -H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "linkIds": ["link_abc123", "link_def456", "link_ghi789"]
  }'
const response = await fetch('https://api.bouncy.ai/v1/links/bulk', {
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    linkIds: ['link_abc123', 'link_def456', 'link_ghi789']
  })
});

const result = await response.json();
console.log(`Deleted ${result.summary.succeeded} links`);
import requests

response = requests.delete(
    'https://api.bouncy.ai/v1/links/bulk',
    headers={
        'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'linkIds': ['link_abc123', 'link_def456', 'link_ghi789']
    }
)

result = response.json()
print(f"Deleted {result['summary']['succeeded']} links")
{
  "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
  }
}
{
  "error": {
    "code": "invalid_request",
    "message": "linkIds array is required"
  }
}
{
  "error": {
    "code": "too_many_links",
    "message": "Maximum 100 link IDs allowed per request. You provided 150."
  }
}

Request

Headers

Content-Type
string
required
Must be application/json

Body

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 "Authorization: Bearer bcy_live_pk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "linkIds": ["link_abc123", "link_def456", "link_ghi789"]
  }'
const response = await fetch('https://api.bouncy.ai/v1/links/bulk', {
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    linkIds: ['link_abc123', 'link_def456', 'link_ghi789']
  })
});

const result = await response.json();
console.log(`Deleted ${result.summary.succeeded} links`);
import requests

response = requests.delete(
    'https://api.bouncy.ai/v1/links/bulk',
    headers={
        'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'linkIds': ['link_abc123', 'link_def456', 'link_ghi789']
    }
)

result = response.json()
print(f"Deleted {result['summary']['succeeded']} links")
{
  "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
  }
}
{
  "error": {
    "code": "invalid_request",
    "message": "linkIds array is required"
  }
}
{
  "error": {
    "code": "too_many_links",
    "message": "Maximum 100 link IDs allowed per request. You provided 150."
  }
}