Buckets

Get a bucket

GET/v1/workspaces/{workspaceId}/buckets/{bucketId}

Returns one bucket.

Authentication

Send your Spark API key with every request. The value is the full bearer token Spark returned when you created the key. See Authentication.

Authorization: Bearer <SPARK_API_KEY>

Path parameters

workspaceId

string

The workspace id.

bucketId

string

The storage bucket id.

Was this page helpful?

curl \
  --url "https://api.beta.graphon.ai/v1/workspaces/wspQ7WsH2Np5L/buckets/bktA1b2C3d4E5" \
  --header "Authorization: Bearer $SPARK_API_KEY"

Response

JSON

{
  "id": "bktA1b2C3d4E5",
  "workspaceId": "wspQ7WsH2Np5L",
  "name": "catalog-assets",
  "provider": "gcp",
  "location": "us",
  "storageClass": "standard",
  "permission": "private",
  "phase": "active",
  "availability": "online",
  "objectCount": 0,
  "revision": 1,
  "createdAt": "2026-09-15T18:00:00.000Z"
}