# drive_activity

Drive Activity Log

## 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

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

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