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

> Permanently deletes a task.

<Warning>This action is irreversible.</Warning>

<Info>
  Requires the `tasks:write` scope. Viewers cannot delete tasks.
  Access-restricted members receive `403` if the task belongs to a list outside
  their permitted scope.
</Info>

## Path parameters

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

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