> ## Documentation Index
> Fetch the complete documentation index at: https://docs.linquid.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Link

> Soft-delete a link and invalidate link/analytics cache paths

<ParamField path="linkId" type="string" required>
  Link identifier
</ParamField>

## Access

* Permission: `links:delete`

Behavior:

* Performs soft delete.
* Invalidates redirect and analytics caches for the link.
* Emits link-deleted webhook events in workspace scope.

<RequestExample>
  ```bash cURL theme={null}
  curl -X DELETE https://api.linquid.io/api/links/link_abc123 \
    -H "Authorization: Bearer <token>"
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true,
    "data": {
      "deleted": true
    }
  }
  ```
</ResponseExample>

## Common Errors

* `404`: link not found