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

# Listar arquivos

> Lista o conteúdo de um diretório.

Lista o conteúdo de um diretório. Cada item informa o tipo e o nome. `size`, quando presente, está em bytes. `lastModified` é um timestamp em milissegundos ou `null`.

## Parâmetros

**appId** `string` *required*

ID da aplicação, obtido no painel ou em `response.applications[].id` ao [consultar a conta](https://docs.dscloud.pt/api-reference/endpoint/users/me.md).

**path** `string`

Diretório a listar. O padrão é `/`.

## Resposta

HTTP 200. `response` é um array.

```json HTTP 200 theme={null}
{
  "status": "success",
  "code": "SUCCESS",
  "response": [
    {
      "type": "file",
      "name": "index.js",
      "size": 84,
      "lastModified": 1795168800000
    }
  ],
  "success": true
}
```

## Erros desta operação

| HTTP | Código | Quando ocorre |
| - | - | - |
| 404 | `SERVER_NOT_FOUND` | Aplicação não encontrada. |
| 504 | `REQUEST_TIMEOUT` | Tempo esgotado na listagem. |

```bash cURL theme={null}
: "${DSCLOUD_API_BASE_URL:=https://api.dscloud.pt/v3}"
curl --proto '=https' --fail-with-body --request GET \
  --header "Authorization: ${DSCLOUD_API_KEY:?Defina DSCLOUD_API_KEY}" \
  "${DSCLOUD_API_BASE_URL%/}/apps/${DSCLOUD_APP_ID:?Defina DSCLOUD_APP_ID}/files?path=%2F"
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.