> For the complete documentation index, see [llms.txt](https://docs.floui.io/guia/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.floui.io/guia/conectores/categorias/manipulacao-de-arquivos/file-list.md).

# File List

{% tabs %}
{% tab title="Parâmetros" %}

<figure><img src="/files/zhrFMcWEsZyPqI6DIX9r" alt=""><figcaption><p>Parâmetros de configuração</p></figcaption></figure>

| Campo                | Tipo           | Descrição                                                                                                                      |
| -------------------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| Descrição            | Campo de texto | Descrição visual do conector na construção do fluxo.                                                                           |
| Localização da pasta | Campo de texto | Indica a localização da pasta dentro do storage no Workspace atual. Pode ser utilizado “/” como prefixo para caminho absoluto. |
| Output path          | Campo de texto | Define o nome de um atributo que irá armazenar a saída de dados do conector dentro do objeto msg no contexto do fluxo atual.   |
| {% endtab %}         |                |                                                                                                                                |

{% tab title="Payload" %}

## Sucesso

Considerando que os parâmetros de configuração foram informados corretamente, poderemos acessar as estruturas de pastas através de um array de objetos contendo três atributos, directory, name e size. Veja mais logo abaixo:

<figure><img src="/files/2CdngkyO0PxzBfQe0zMw" alt=""><figcaption><p>O componente File List encontrou um arquivo no diretório pesquisado.</p></figcaption></figure>

<table data-column-title-hidden data-view="cards"><thead><tr><th>Campo</th><th>Tipo</th><th>Descrição</th></tr></thead><tbody><tr><td>D<strong>irectory</strong></td><td>Boolean</td><td>Permite identificar se o objeto é uma pasta ou arquivo.</td></tr><tr><td>N<strong>ame</strong></td><td>String</td><td>Define o nome do objeto.</td></tr><tr><td>S<strong>ize</strong></td><td>Int</td><td>Define o tamanho em bytes do objeto encontrado.</td></tr></tbody></table>

## Erro

Caso o diretório passado como parâmetro não existe, nenhum retorno será oferecido no payload do componente. Uma mensagem de erro nos logs do fluxo será exibida.

<figure><img src="/files/6GqRkjFKqzL4TyVV0arp" alt=""><figcaption><p>Evento interno do fluxo.</p></figcaption></figure>
{% endtab %}
{% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.floui.io/guia/conectores/categorias/manipulacao-de-arquivos/file-list.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.