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

# Lister les fichiers

> Lister les fichiers de votre application.

<ParamField header="Authorization" type="string" placeholder="API Key" required>
  La clé d'API de votre compte. Vous pouvez la trouver dans les [paramètres de votre compte](https://squarecloud.app/fr/account/security).
</ParamField>

### Paramètres

<ParamField path="app_id" type="string" placeholder="Application ID" required>
  L'ID de l'application. Vous pouvez le trouver dans l'URL du tableau de bord de votre application.
</ParamField>

<ParamField query="path" type="string" placeholder="Path to list" required>
  Le chemin du répertoire dont vous souhaitez lister les fichiers. Par défaut, il s'agit du répertoire racine.
</ParamField>

### Réponse

<ResponseField name="status" type="string">
  Indique si l'appel a réussi. `success` en cas de succès, `error` sinon.
</ResponseField>

<ResponseField name="response" type="array">
  La liste des fichiers et répertoires dans le chemin spécifié.

  <Expandable title="Afficher l'objet">
    <ResponseField name="type" type="string">
      Le type de l'entrée. Peut être `file` ou `directory`.
    </ResponseField>

    <ResponseField name="name" type="string">
      Le nom du fichier ou du répertoire.
    </ResponseField>

    <ResponseField name="size" type="number">
      La taille du fichier en octets. Pour les répertoires, elle vaut 0.
    </ResponseField>

    <ResponseField name="lastModified" type="number">
      L'horodatage de la dernière modification du fichier ou du répertoire, en millisecondes depuis l'epoch.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
      "status": "success",
      "response": [
          {
              "type": "file",
              "name": ".env",
              "size": 86,
              "lastModified": 1676168978000
          },
          {
              "type": "file",
              "name": ".gitignore",
              "size": 8,
              "lastModified": 1675125328000
          },
          {
              "type": "file",
              "name": "index.js",
              "size": 614,
              "lastModified": 1676168350000
          },
          {
              "type": "file",
              "name": "squarecloud.app",
              "size": 65,
              "lastModified": 1676169188000
          },
          {
              "type": "directory",
              "name": "src",
              "lastModified": 1676155738000
          }
      ]
  }
  ```
</ResponseExample>