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

# File Converter

> Convert, merge, split, OCR, watermark, encrypt, and inspect files — powered by CloudConvert.

## Overview

The File Converter pack is a comprehensive document- and media-processing toolkit powered by CloudConvert. Supported operations span 200+ formats and include conversion, optimization, merging, splitting, OCR, image-to-text, watermarking, encryption, and metadata extraction.

**Use cases**

* Ingesting heterogeneous customer uploads (PDF, DOCX, PNG, MP4…) into a uniform format
* Building document-workflow agents (contract, invoice, report processing)
* Adding CONFIDENTIAL / DRAFT watermarks for compliance or previews

***

## Pack actions

| Stage       | Action                                    | Purpose                                                                                                      |
| ----------- | ----------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| FC1         | `file_converter_convert_action`           | Convert a file from one format to another (200+ formats).                                                    |
| FC1\_Report | `file_converter_render_conversion_report` | Render conversion results as an HTML report with download links.                                             |
| FC2         | `file_converter_optimize_action`          | Compress/optimize PDF, PNG, or JPG without changing format.                                                  |
| FC3         | `file_converter_merge_action`             | Combine multiple files into a single PDF (auto-converts inputs).                                             |
| FC4         | `file_converter_metadata_action`          | Extract metadata — EXIF, PDF properties, video resolution/duration. Does **not** consume conversion credits. |
| FC5         | `file_converter_ocr_action`               | Add a searchable text layer to scanned PDFs.                                                                 |
| FC6         | `file_converter_image_to_text_action`     | OCR an image → returns searchable PDF + plain `.txt` file.                                                   |
| FC7         | `file_converter_split_action`             | Split a PDF into one file per page.                                                                          |
| FC8         | `file_converter_encrypt_action`           | Password-protect a PDF.                                                                                      |
| FC9         | `file_converter_watermark_action`         | Add a text watermark (CONFIDENTIAL, DRAFT, etc.) to a PDF or image.                                          |

## Typical flows

**Inbound document normalization**

```mermaid theme={null}
graph LR
  A[User upload] --> B[FC4 Metadata]
  B --> C[FC1 Convert → PDF]
  C --> D[FC5 OCR]
  D --> E[Save / index]
```

**Secure outbound share**

```mermaid theme={null}
graph LR
  A[Report PDF] --> B[FC9 Watermark]
  B --> C[FC8 Encrypt]
  C --> D[Send Message]
```

## Related

* [Convert File](/actions/convert_file) — the lightweight single-step converter.
* [Save to File](/actions/save_to_file) to persist final outputs.
* Full endpoint details in the [API Reference](/api-reference).