List All Buckets

Retrieve a paginated list of all buckets across all users.
EndpointMethodAdmin Required
/api/v1/admin/bucketsGETYes

Returns a paginated list of all buckets in the system, including the owner information.

Unlike the user endpoint, this returns buckets from all users.

Query Parameters

page
integer
Page number. Default: 1
per
integer
Items per page. Default: 10

Response

{
    "metadata": {
        "page": 1,
        "per": 10,
        "total": 3
    },
    "items": [
        {
            "id": "B1C2D3E4-F5G6-7890-HIJK-LM1234567890",
            "name": "production-assets",
            "creationDate": "2025-01-15T10:30:00Z",
            "versioningStatus": "Enabled",
            "user": {
                "id": "63717CB9-DE10-44D2-AC69-774F57F6C148",
                "name": "Admin User",
                "username": "alarik"
            }
        },
        {
            "id": "C2D3E4F5-G6H7-8901-IJKL-MN2345678901",
            "name": "user-uploads",
            "creationDate": "2025-01-10T08:15:00Z",
            "versioningStatus": "Disabled",
            "user": {
                "id": "A1B2C3D4-E5F6-7890-ABCD-EF1234567890",
                "name": "John Doe",
                "username": "john"
            }
        }
    ]
}

Response Fields

id
string
Unique bucket identifier (UUID).
name
string
Bucket name.
creationDate
string
ISO 8601 timestamp of when the bucket was created.
versioningStatus
string
Versioning status: Disabled, Enabled, or Suspended.
user
object
Owner information including id, name, and username.

Delete User

Permanently delete a user and all their data from Alarik.

Delete Bucket

Permanently delete any bucket as an admin.