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

# Delete list

> Permanently deletes a list and all tasks inside it.

<Warning>
  This action is irreversible. Deleting a list cascades to all tasks inside it.
</Warning>

<Info>Requires the `lists:write` scope.</Info>

## Path parameters

<ParamField path="id" type="string" required>
  The numeric list ID.
</ParamField>

## Response

Returns `204 No Content` with an empty body on success.

<ResponseExample>
  ```204 No Content theme={null}
  ```

  ```json 401 theme={null}
  {
    "error": "Invalid API key"
  }
  ```

  ```json 403 theme={null}
  {
    "error": "Scope 'lists:write' is required for this endpoint"
  }
  ```

  ```json 404 theme={null}
  {
    "error": "List not found"
  }
  ```
</ResponseExample>