Vaze
API Reference

Activity

Read and prune your activity history

Vaze keeps a history of each user's uploads, deletions and API key changes, plus the account changes an admin makes. It is what the Activity page in the dashboard and the mobile app shows. These endpoints need a signed-in session and no scope; a request made with an API key gets a 403.

Every call only sees the caller's own entries. An entry looks like this:

{
  "id": "4c1f9a7e-...",
  "type": "upload.succeeded",
  "target": "3 files",
  "detail": "report.pdf, photo.jpg, notes.txt",
  "createdAt": "2026-10-14 09:12:44"
}

target is what the event happened to, such as a file or key name, and detail an optional extra line, such as the error that failed an upload. createdAt is a UTC timestamp without a zone marker.

typeRecorded when
upload.succeeded, upload.failed, upload.canceledAn upload request finishes
file.deleted, file.delete-failedFiles are deleted
folder.deleted, folder.delete-failedA folder is deleted
api-key.created, api-key.renamed, api-key.deletedThe caller changes one of their keys
user.created, user.access-changed, user.password-reset, user.disabled, user.enabled, user.deletedAn admin changes an account

Entries older than the activity retention set under instance settings are deleted automatically.

List entries

GET /api/activity

Returns the 200 most recent entries, newest first:

{ "data": { "activities": [ ... ] }, "error": null }

Delete entries

DELETE /api/activity
// some entries
{ "ids": ["4c1f9a7e-...", "8d0b2c11-..."] }

// every entry
{ "all": true }

Responds with how many entries were removed, { "deleted": 2 }. Ids that aren't the caller's are skipped. Files, keys and accounts are never affected.

On this page