# drive_folder_list

List Folder Contents

## Beschreibung

Lists the immediate children (folders + files, both live) of
the given folder — or the drive's root when `folder_id` is
omitted. Each row carries `kind = folder | file`, size /
content_type for files, updated_at, uploader / creator.
Not recursive — call again for each folder you want to
descend into.

## Zugriff

Zugriffsprofil: `gated`. Module: `files`.
Die Freigabe im Profil ersetzt keine Account-, Workspace- oder Rollenberechtigung.

## Parameter

| Name | Typ | Pflicht | Beschreibung |
| --- | --- | --- | --- |
| `account_id` | string | Ja |  |
| `drive_id` | string | Ja |  |
| `folder_id` | string | Nein | Folder prefix ID (dfo_…). Omit to list the drive's root. |

## Eingabeschema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "account_id": {
      "type": "string"
    },
    "drive_id": {
      "type": "string"
    },
    "folder_id": {
      "type": "string",
      "description": "Folder prefix ID (dfo_…). Omit to list the drive's root."
    }
  },
  "required": [
    "account_id",
    "drive_id"
  ],
  "type": "object"
}
```

## Ausgabeschema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "drive_id": {
      "type": "string"
    },
    "folder_id": {
      "type": [
        "string",
        "null"
      ],
      "description": "The folder we listed under, or null for root."
    },
    "breadcrumb": {
      "type": "array",
      "description": "Path from root down to (but not including) the current folder, deepest last.",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          }
        }
      }
    },
    "entries": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "kind": {
            "type": "string",
            "enum": [
              "folder",
              "file"
            ]
          },
          "name": {
            "type": "string"
          },
          "content_type": {
            "type": [
              "string",
              "null"
            ],
            "description": "File MIME (null for folders)."
          },
          "byte_size": {
            "type": [
              "integer",
              "null"
            ],
            "description": "File size in bytes (null for folders)."
          },
          "folder_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "Parent folder id — matches the request's folder_id."
          },
          "uploaded_by": {
            "type": [
              "object",
              "null"
            ]
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "id",
          "kind",
          "name",
          "content_type",
          "byte_size",
          "folder_id",
          "uploaded_by",
          "updated_at"
        ]
      }
    }
  },
  "required": [
    "drive_id",
    "folder_id",
    "breadcrumb",
    "entries"
  ],
  "type": "object"
}
```