bucketpilot/Docs

Usage & activity

Storage totals, cost estimates, and the activity feed.

Usage

GET /v1/usage returns workspace totals and a per-bucket breakdown. Cost estimates come from indexed storage-class data, so unindexed buckets report estMonthlyCostUsd: null. The payload is cached for up to 10 minutes.

json
{
  "totalStorageBytes": 2199023255552,
  "totalObjects": 189342,
  "bucketCount": 7,
  "estMonthlyCostUsd": 50.62,
  "buckets": [
    { "id": 12, "name": "prod-data", "storageBytes": 734003200000, "objectCount": 48210, "estMonthlyCostUsd": 16.89 }
  ]
}

Activity feed

GET /v1/activity?limit=50 returns the newest activity events (max 100 per request): uploads, job starts and completions, credential and bucket changes, policy updates.

json
{
  "events": [
    {
      "id": 9911,
      "type": "job_started",
      "description": "Replication job \"nightly-prod-backup\" started via API (key bp_1a2b3c4d…)",
      "bucketName": null,
      "jobName": "nightly-prod-backup",
      "createdAt": "2026-07-16T02:00:04.000Z"
    }
  ]
}
© 2026 BucketPilot