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

# Required Confirmation

> Require user confirmation before executing a tool

## Overview

Require user confirmation before executing a tool.

## Usage

```python theme={null}
from upsonic.tools import tool

@tool(requires_confirmation=True)
def delete_file(file_path: str) -> str:
    """
    Delete a file from the system.

    Args:
        file_path: Path to the file to delete

    Returns:
        Confirmation message
    """
    import os
    os.remove(file_path)
    return f"File {file_path} deleted successfully"
```

## Parameters

* `requires_confirmation` (bool): If True, prompts user with "Proceed? (y/n)" before execution