API Reference
Hanzo S3 API
Hanzo S3 provides S3-compatible object storage for AI infrastructure.
Hanzo S3 provides S3-compatible object storage for AI infrastructure.
s3Auth — API key in header (Authorization)bearerAuth — HTTP bearerBearerAuth — HTTP bearer
All Hanzo APIs share one bearer credential and common error and pagination conventions. See API conventions.
curl -H "Authorization: Bearer $HANZO_API_KEY" https://s3.hanzo.ai
| Method | Endpoint | Description |
|---|
GET | /v1/s3/admin/info | Server information |
GET | /v1/s3/admin/usage | Storage usage |
GET | /v1/s3/admin/service-accounts | List service accounts |
POST | /v1/s3/admin/service-accounts | Create a service account |
| Method | Endpoint | Description |
|---|
GET | /v1/s3/ | List all buckets |
PUT | /v1/s3/{bucket} | Create a bucket |
DELETE | /v1/s3/{bucket} | Delete a bucket |
| Method | Endpoint | Description |
|---|
GET | /v1/s3/{bucket}?encryption | Get encryption configuration |
PUT | /v1/s3/{bucket}?encryption | Set encryption configuration |
| Method | Endpoint | Description |
|---|
GET | /v1/s3/{bucket}?notification | Get event notification config |
PUT | /v1/s3/{bucket}?notification | Set event notification config |
| Method | Endpoint | Description |
|---|
GET | /health | Health check |
| Method | Endpoint | Description |
|---|
GET | /v1/s3/{bucket}?lifecycle | Get lifecycle rules |
PUT | /v1/s3/{bucket}?lifecycle | Set lifecycle rules |
| Method | Endpoint | Description |
|---|
GET | /v1/s3/{bucket} | List objects in bucket |
GET | /v1/s3/{bucket}/{key} | Download an object |
PUT | /v1/s3/{bucket}/{key} | Upload an object |
DELETE | /v1/s3/{bucket}/{key} | Delete an object |
HEAD | /v1/s3/{bucket}/{key} | Get object metadata |
| Method | Endpoint | Description |
|---|
GET | /v1/s3/{bucket}?policy | Get bucket policy |
PUT | /v1/s3/{bucket}?policy | Set bucket policy |
| Method | Endpoint | Description |
|---|
GET | /v1/s3/{bucket}?versioning | Get versioning status |
PUT | /v1/s3/{bucket}?versioning | Set versioning status |
Hanzo S3 API guide · All Hanzo APIs · OpenAPI spec
How is this guide?