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

# Delete Item

> Permanently remove an item from your library.

## Path Parameters

<ParamField path="id" type="string" required>
  The item ID. Example: `itm_r9f3a`.
</ParamField>

## Response

Returns `204 No Content` on success. The item and all associated data (annotations, tags) are permanently removed.

<Warning>
  This action is irreversible. If you want to keep the item but move it out of your queue, update its status to `archive` instead.
</Warning>

<RequestExample>
  ```bash cURL theme={null}
  curl -X DELETE https://api.getmatter.com/public/v1/items/itm_r9f3a \
    -H "Authorization: Bearer mat_your_token_here"
  ```

  ```python Python theme={null}
  response = requests.delete(
      "https://api.getmatter.com/public/v1/items/itm_r9f3a",
      headers={"Authorization": f"Bearer {token}"}
  )
  assert response.status_code == 204
  ```
</RequestExample>

<ResponseExample>
  ```json 204 theme={null}
  (No content)
  ```

  ```json 404 theme={null}
  {
    "error": {
      "code": "not_found",
      "message": "No item found with ID itm_r9f3a."
    }
  }
  ```
</ResponseExample>