Skip to main content
GET
/
storage
/
obj
/
{bucket}
Get an object store bucket
curl --request GET \
  --url https://api.quiva.ai/storage/obj/{bucket} \
  --header 'Authorization: Bearer <token>'
{
  "body": {
    "status": {
      "bucket": "media-assets",
      "description": "Production media files",
      "bytes": 5368709120,
      "objects": 1523,
      "sealed": false
    },
    "config": {
      "bucket": "media-assets",
      "max_bytes": 10737418240,
      "num_replicas": 3,
      "storage": "file",
      "placement": {
        "cluster": "us-east-1",
        "tags": [
          "ssd",
          "high-iops"
        ]
      }
    },
    "stream_info": {
      "cluster": {
        "name": "prod-cluster",
        "leader": "node-1",
        "replicas": [
          {
            "name": "node-2",
            "current": true,
            "active": 0
          },
          {
            "name": "node-3",
            "current": true,
            "active": 0
          }
        ]
      },
      "created": "2024-01-15T10:30:00Z",
      "state": {
        "bytes": 5368709120,
        "messages": 1523,
        "first_seq": 1,
        "last_seq": 1523,
        "first_ts": "2024-01-15T10:31:00Z",
        "last_ts": "2024-11-28T09:45:00Z"
      }
    }
  },
  "metadata": {
    "bucket": "media-assets",
    "duration": "8ms"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
bucket
string
required

Name of the bucket

Response

Successfully retrieved bucket information

​
body
object
​
metadata
object