Zum Inhalt
Für Agenten

MCP Reference

drive_folder_list

List Folder Contents

Markdown Tools als JSON

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

{
  "$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

{
  "$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"
}
Seiten