List Buckets

Retrieve your own buckets with pagination.
EndpointMethodAdmin Required
/api/v1/bucketsGETNo

Returns a paginated list of buckets owned by the authenticated user.

Query Parameters

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

Response

{
    "metadata": {
        "page": 1,
        "per": 10,
        "total": 2
    },
    "items": [
        {
            "id": "B1C2D3E4-F5G6-7890-HIJK-LM1234567890",
            "name": "my-assets",
            "creationDate": "2025-01-15T10:30:00Z",
            "versioningStatus": "Enabled"
        },
        {
            "id": "C2D3E4F5-G6H7-8901-IJKL-MN2345678901",
            "name": "backups",
            "creationDate": "2025-01-10T08:15:00Z",
            "versioningStatus": "Disabled"
        }
    ]
}

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 Endpoints

API endpoints for managing your own buckets and objects.

Set Bucket Tags

Replace the tags on a bucket you own.