Buckets

​

Operations

​

List accessible buckets

GET /buckets/all

curl "https://api.everabyte.io/api/buckets/all" \
  -H "X-Public-Key: $EVB_PUBLIC_KEY" \
  -H "X-Secret-Key: $EVB_SECRET_KEY"

{
  "status": 200,
  "message": "Buckets retrieved",
  "data": [
    {
      "id": "0f0b0c7e-6a1f-4b8e-9a3e-1f2c3d4e5f60",
      "name": "company-default",
      "code": "company-default",
      "retentionPeriod": null,
      "datacenterId": "dc-frankfurt-01",
      "createdAt": "2026-09-01T08:00:00.000Z",
      "updatedAt": "2026-09-01T08:00:00.000Z"
    }
  ]
}

• A key restricted to specific buckets sees only those buckets in the list. Out-of-scope buckets are filtered out silently; there is no separate error.
• datacenterId is the only location signal on bucket records. Available locations are chosen at bucket creation in the dashboard, and the platform’s datacenter and region routes are session-only — they are not reachable with an API key. See Data residency.
• The default bucket (name equal to code) is created automatically at provisioning and cannot be deleted.

​

Read bucket size

GET /buckets/size/{bucketId}

curl "https://api.everabyte.io/api/buckets/size/$EVB_BUCKET_ID" \
  -H "X-Public-Key: $EVB_PUBLIC_KEY" \
  -H "X-Secret-Key: $EVB_SECRET_KEY"

{
  "status": 200,
  "message": "Bucket size checked",
  "data": {
    "totalSize": "1.2 GB",
    "totalSizeBytes": 1288490188
  }
}

• The size counts non-deleted files only. Files in trash are excluded, so the value can drop when a hard delete purges trash.
• The size reflects stored content in the bucket, not the plan’s capacity ceiling. Plan capacity is visible in the dashboard.
• An unknown bucket, or one outside the caller’s tenant, returns 404.
• A restricted key asking for a bucket outside its scope returns 403 API_BUCKET_SCOPE_DENIED.

​

What stays in the dashboard

​

Related