> ## 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 folder

> Permanently deletes a folder and all lists and tasks inside it.

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

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

## Path parameters

<ParamField path="id" type="string" required>
  The numeric folder 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 'folders:write' is required for this endpoint"
  }
  ```

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