> ## 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 list

> List Instance file artifacts.

Lists recent Instance artifacts (Telegram, email, uploads).

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

Inspector **Settings**. Empty-field rules for the Graph: [Previous nodes](/graph/previous-nodes). This inspector has no **Insert value**.

On an Agent Tool, **Limit** can be **Agent decides** or **Fixed**.

| Field     | Required | Empty         | Notes               |
| --------- | -------- | ------------- | ------------------- |
| **Limit** | No       | Default: `20` | 1–50. Newest first. |

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

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

| Output | In menu | Type          | Next node gets                                                                                                                                                                                                                                            |
| ------ | ------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Result | Yes     | Markdown text | A catalog. Empty Instance: `No artifacts on this instance.` Each row starts with `id=\`…\`\`. That id is what [Files get](/graph/tools/files-get) and [Files extract](/graph/tools/files-extract#file-id) need — not this whole Result, not the filename. |
