# Delete a link

`DELETE https://app.clik.so/api/links/{id}`

> **In short:** Deletes a link so its short URL stops working at once. The response is `204` with an empty body.

## 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/3f6c1a2e-9b4d-4e8f-a1c2-7d9e0f1a2b3c" \
  -H "Authorization: Bearer $CLIKSO_API_KEY"
```

Response 204 No Content — an empty body means it worked.

## Parameters

| Name | In   | Type   | Required | Description    |
| ---- | ---- | ------ | -------- | -------------- |
| `id` | path | string | yes      | The link's id. |

## 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. |
| 404    | `NOT_FOUND`    | No live link with this id exists in the key's workspace.                        |
| 409    | `CONFLICT`     | Clikso removed this link for abuse, so it cannot be deleted.                    |
| 429    | `RATE_LIMITED` | The key went over its per-minute request limit.                                 |

## Good to know

* A deleted link cannot be restored through the API. To turn a link off for now, set its `status` to `archived` with [Update a link](https://clik.so/docs/api/links/update-link) instead.
* A deleted link no longer counts toward this month's link limit, and its short code becomes free to use again on that domain.
* A link that Clikso removed for abuse cannot be deleted. You get `409 CONFLICT`.
* The `204` response has no body. Do not try to parse it as JSON.

---

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