Zum Inhalt
Für Agenten

MCP Reference

drive_activity

Drive Activity Log

Markdown Tools als JSON

Beschreibung

Returns the audit log for a drive — same rows the Activity tab renders. Filter by kinds (an array of action strings) or since (ISO 8601 / relative offset). Sorted created_at DESC, capped at 100 rows per call. Manager only.

Common action strings: file_uploaded, file_downloaded, file_renamed, file_moved, file_trashed, file_restored, file_purged, file_fetched, folder_created, folder_moved, folder_trashed, folder_restored, bulk_zip_downloaded, link_created, link_updated, link_revoked, link_restored, link_downloaded, drive_created, drive_archived, drive_restored.

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
kinds array Nein Filter to these action strings only.
since string Nein ISO 8601, date, or relative offset (-1d, -2h). Rows older than this are dropped.

Eingabeschema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "account_id": {
      "type": "string"
    },
    "drive_id": {
      "type": "string"
    },
    "kinds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter to these action strings only."
    },
    "since": {
      "type": "string",
      "description": "ISO 8601, date, or relative offset (`-1d`, `-2h`). Rows older than this are dropped."
    }
  },
  "required": [
    "account_id",
    "drive_id"
  ],
  "type": "object"
}

Ausgabeschema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "drive_id": {
      "type": "string"
    },
    "count": {
      "type": "integer"
    },
    "events": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "action": {
            "type": "string"
          },
          "actor": {
            "type": [
              "object",
              "null"
            ],
            "description": "User who did it, or null for anonymous public-link downloads."
          },
          "target_type": {
            "type": [
              "string",
              "null"
            ]
          },
          "target_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "Prefix ID of the DriveFile / DriveFolder / DriveLink if applicable."
          },
          "payload": {
            "type": "object"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          }
        }
      }
    }
  },
  "required": [
    "drive_id",
    "count",
    "events"
  ],
  "type": "object"
}
Seiten