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

# Files get

> Read one artifact preview.

Returns artifact metadata and an extracted text preview.

<h2 id="input">
  Input
</h2>

Inspector **Settings**. Empty-field rules for the Graph: [Previous nodes](/graph/previous-nodes). This inspector has no **Insert value**; you can type `{{…}}`.

On an Agent Tool, **File id** can be **Agent decides** or **Fixed**. **Max characters** is always your value on the node.

| Field              | Required | Empty           | Notes                                                                                                                                                                                                    |
| ------------------ | -------- | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **File id**        | Yes      | Fail            | Opaque id from [Files list](/graph/tools/files-list#output) or [Photos / Files](/graph/previous-nodes#attachments). Same rules as [Files extract](/graph/tools/files-extract#file-id). Not the filename. |
| **Max characters** | No       | Default: `8000` | 500–48000.                                                                                                                                                                                               |

<h2 id="output">
  Output
</h2>

On the next node, **Previous nodes** lists **`Files get`: Result** (`{{Files get.text}}` while the name is unique).

| Output | In menu | Type          | Next node gets                                                                                                                                |
| ------ | ------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| Result | Yes     | Markdown text | Header (`## {name}`, id, kind, source, status, mime) plus extracted text clipped to **Max characters**. Empty extract: `(no extracted text)`. |
