# Read

Required Frends version: 5.7+

Required .NET version: 8.0

Compatible Agents: Unknown

Source code: <https://github.com/FrendsPlatform/Frends.Pdf/tree/main/Frends.Pdf.Read>

{% tabs %}
{% tab title="Parameter: Input" %}

| Name                | Description                                                                                                   |
| ------------------- | ------------------------------------------------------------------------------------------------------------- |
| FilePath : `String` | <p>Full path to the PDF file.</p><p><br>Default: <code>-</code><br>Example: <code>C:\temp\file.pdf</code></p> |
| {% endtab %}        |                                                                                                               |

{% tab title="Parameter: Options" %}

| Name                             | Description                                                                                                                    |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| IncludeImages : `Boolean`        | <p>Include images in result.</p><p><br>Default: <code>False</code><br>Example: <code>false</code></p>                          |
| ThrowErrorOnFailure : `Boolean`  | <p>Whether to throw an error on failure.</p><p><br>Default: <code>True</code><br>Example: <code>true</code></p>                |
| ErrorMessageOnFailure : `String` | <p>Overrides the error message on failure.</p><p><br>Default: <code>-</code><br>Example: <code>Custom error message</code></p> |
| {% endtab %}                     |                                                                                                                                |

{% tab title="Result: Result" %}

| Name                | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Success : `Boolean` | <p>Indicates if the task completed successfully.<br>Example: <code>true</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| Json : `String`     | <p>JSON representation of the extracted PDF content, including document metadata and page-level content. Text is extracted in reading order; tables and columns are flattened. Images (if IncludeImages is true) are returned as a byte array, with its width and height. If the extraction library could convert the image, Format is "PNG"; otherwise Format is "RAW". A single visible image may produce multiple extracted images due to transparency masks or internal PDF structure.<br>Example: <code>{ "Metadata": { "Title": "Example PDF", "Author": "John Doe", "PageCount": 2 }, "Pages": \[ { "Number": 1, "Text": "Hello world", "Images": \[] }, { "Number": 2, "Text": "Second page text", "Images": \[] } ] }</code></p> |
| Error : `Error`     | <p>Error that occurred during task execution.<br>Example: <code>object { string Message, Exception AdditionalInfo }</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| {% endtab %}        |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |

{% tab title="Changelog" %}

## Changelog

### \[1.2.0] - 2026-02-23

#### Fixed

* Ensure FrendsTaskMetadata.json is included in NuGet package

### \[1.1.0] - 2026-02-03

#### Changed

* Rename task prefix from PDF to Pdf

### \[1.0.0] - 2026-01-19

#### Added

* Initial implementation
  {% endtab %}
  {% endtabs %}
