Object Storage (S3)

S3-compatible object storage operations backed by Ceph RGW. All endpoints require X-S3-Access-Key and X-S3-Secret-Key headers.

List Buckets

GET /s3/buckets

List all S3 buckets accessible with the provided credentials.

Response

[
  {
    "name": "my-bucket",
    "creationDate": "2026-01-15T08:30:00Z"
  },
  {
    "name": "backups",
    "creationDate": "2026-02-20T14:00:00Z"
  }
]

Create Bucket

POST /s3/buckets

Create a new S3 bucket.

Request body

name string required

Bucket name

Response

{ "status": "created" }

List Objects

GET /s3/buckets/{bucket}/objects

List objects in a bucket. Supports pagination and prefix filtering.

Query parameters

prefix string

Filter by key prefix

continuationToken string

Pagination token from previous response

maxKeys int

Max results per page (1-1000, default 200)

Response

{
  "objects": [
    {
      "key": "documents/report.pdf",
      "size": 1048576,
      "lastModified": "2026-03-10T12:00:00Z",
      "etag": "d41d8cd98f00b204e9800998ecf8427e"
    }
  ],
  "isTruncated": false,
  "continuationToken": ""
}

Delete Object

POST /s3/buckets/{bucket}/objects/delete

Delete an object from a bucket.

Request body

key string required

Object key to delete

Response

{ "status": "deleted" }