# Delete many links

`DELETE https://app.clik.so/api/links/bulk`

> **In short:** Deletes up to 100 links in one call. Their short URLs stop working at once.

## You need

* **API key permission:** `write`
* **Workspace role:** editor or higher
* **Plan:** any plan, including Free

## Example

```bash
curl -X DELETE "https://app.clik.so/api/links/bulk" \
  -H "Authorization: Bearer $CLIKSO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ids": [
      "3f6c1a2e-9b4d-4e8f-a1c2-7d9e0f1a2b3c",
      "5d4c3b2a-1f0e-4d9c-8b7a-6f5e4d3c2b1a"
    ]
  }'
```

Response 200:

```json
{
  "status": 200,
  "success": true,
  "message": "Success",
  "data": {
    "deleted_count": 2,
    "skipped_banned_count": 0,
    "skipped_banned_ids": []
  }
}
```

## Request body

| Field | Type                   | Required | Description                                       |
| ----- | ---------------------- | -------- | ------------------------------------------------- |
| `ids` | array of string · uuid | yes      | The links to delete, at most 100. Up to 100 items |

## Common errors

| Status | Code               | When                                                                            |
| ------ | ------------------ | ------------------------------------------------------------------------------- |
| 401    | `UNAUTHORIZED`     | The API key is missing, malformed or unknown.                                   |
| 403    | `FORBIDDEN`        | The key only has Read permission, or its creator is a viewer in this workspace. |
| 422    | `VALIDATION_ERROR` | `ids` is missing, empty or has more than 100 entries.                           |
| 429    | `RATE_LIMITED`     | The key went over its per-minute request limit.                                 |

## Good to know

* Send at most 100 ids per call.
* This is a `DELETE` with a JSON body. Most HTTP clients allow that; the examples show how.
* Ids that do not exist or are already deleted are skipped. `deleted_count` tells you how many were deleted.
* Links that Clikso removed for abuse are skipped, not deleted, and listed in `skipped_banned_ids`.

---

Source: https://clik.so/docs/api/links/bulk-delete-links