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

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

The question should be specific, self-contained, and written in natural language.
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.