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

# File Utils

> Unlocks password-protected files and extracts ZIP archives.

Unlocks password-protected files and extracts ZIP archives. Display name **"File Utils"**. On by default for new agents.

## Authentication and enablement

No integration. Default-on.

## Inputs

* `file_url` (required): `${VAR_N}` of the file.
* `operation` (required): `unlock` or `unzip`.

**`unlock`** — `parameters.password` is **required**. After unlock, the original file is updated in place; keep using the same `${VAR_N}`.

**`unzip`** — extracts supported files (PDF, images, Excel, CSV, PowerPoint, Word, Markdown) from every directory in the archive. Each extracted file gets a new variable. Do **not** unzip `.xlsx` / `.xls` / `.docx` / `.pptx` — those are Office formats that happen to be ZIP internally; send them to `structured_data_extraction` instead.

## Output

Unlocked file (same variable) or a list of extracted file variables.

## Limits and side effects

* Unlock mutates the stored file in place.
* Unzip creates new task files.

## Expected errors

* Missing password on `unlock`.
* Wrong password / unsupported lock.
* Unzip of an Office document (use extraction instead).
* Unsupported `operation`.