Managing Buckets

Buckets are containers for files. The implemented bucket operations are create, list, get, and delete.

Bucket Input

POST /v1/buckets accepts name and description.

• name is trimmed, may be empty, and can contain letters, digits, _, and - up to 64 characters.
• description can be up to 4096 characters.
• If name is empty, the generated bucket ID is used as the name.

Create a Bucket

1curl -X POST "https://api.hola.cloud/v1/buckets" \
2  -H 'X-Glue-Authentication: {"user":{"id":"user-123"}}' \
3  -H "Content-Type: application/json" \
4  -d '{"name":"assets","description":"Application assets"}'

Response:

1{
2  "id": "bucket-550e8400-e29b-41d4-a716-446655440000",
3  "project_id": "",
4  "created_timestamp": 1782045600000000000,
5  "owners": ["user-123"],
6  "name": "assets",
7  "description": "Application assets"
8}

List Buckets

1curl "https://api.hola.cloud/v1/buckets" \
2  -H 'X-Glue-Authentication: {"user":{"id":"user-123"}}'

Response:

 1[
 2  {
 3    "id": "bucket-550e8400-e29b-41d4-a716-446655440000",
 4    "name": "assets",
 5    "description": "Application assets",
 6    "created_timestamp": 1782045600000000000,
 7    "created_h": "2026-06-21T10:00:00Z",
 8    "owners": ["user-123"]
 9  }
10]

Get Bucket Details

1curl "https://api.hola.cloud/v1/buckets/bucket-550e8400-e29b-41d4-a716-446655440000" \
2  -H 'X-Glue-Authentication: {"user":{"id":"user-123"}}'

Response:

1{
2  "id": "bucket-550e8400-e29b-41d4-a716-446655440000",
3  "project_id": "",
4  "created_timestamp": 1782045600000000000,
5  "owners": ["user-123"],
6  "name": "assets",
7  "description": "Application assets"
8}

Modify Bucket

PATCH /v1/buckets/{bucket_id} is registered but not implemented.

Delete Bucket

1curl -X DELETE "https://api.hola.cloud/v1/buckets/bucket-550e8400-e29b-41d4-a716-446655440000" \
2  -H 'X-Glue-Authentication: {"user":{"id":"user-123"}}'

The response body is the deleted bucket object.