Clatter Labs
Console

Code Buckets

List objects

View as Markdown

The zips and assets stored in a bucket.

GETapi.codebuckets.clatterlabs.xyz/v1/buckets/{bucket_id}/objectsbuckets:read

Stored zips and assets, newest first, including unfinished uploads (status uploading).

Authorizations

Authorizationstringrequired

Your API key as a bearer token: Bearer clsk_.... Create keys in the Console with the Code Buckets permissions you need.

X-Clatter-Accountstringrequired

The Account ID that owns the key, like CL-7K2M9QXA. Find it in Console › Settings. A missing value answers 401 missing_account_id; someone else's answers 401 account_mismatch.

Path parameters

bucket_idstringrequired

The bucket id (cbk_…).

Query parameters

limitintegerdefault: 50

How many to return, 1 to 100.

beforestring

A created_at (or at) timestamp: return items before it, for paging.

kindstring

archive or asset.

Response

200 · application/json

objectstring

list.

dataObject[]

Objects. See Get an object.

has_moreboolean

More exist.

Errors

StatusCodeWhen
401invalid_api_key / missing_account_id / account_mismatchThe key or Account ID is wrong.
402quota_exceededThis month's free tokens are used up.
403insufficient_scopeThe key lacks the permission.
404not_foundNo bucket with that id on your account.
curl "https://api.codebuckets.clatterlabs.xyz/v1/buckets/BUCKET_ID/objects?kind=archive" \
  -H "Authorization: Bearer $CLATTER_API_KEY" \
  -H "X-Clatter-Account: $CLATTER_ACCOUNT_ID"
import os
import requests

headers = {
    "Authorization": f"Bearer {os.environ['CLATTER_API_KEY']}",
    "X-Clatter-Account": os.environ["CLATTER_ACCOUNT_ID"],
}

r = requests.get("https://api.codebuckets.clatterlabs.xyz/v1/buckets/BUCKET_ID/objects", params={"kind": "archive"}, headers=headers)
print(r.json())
const headers = {
  Authorization: `Bearer ${process.env.CLATTER_API_KEY}`,
  "X-Clatter-Account": process.env.CLATTER_ACCOUNT_ID,
};

const res = await fetch("https://api.codebuckets.clatterlabs.xyz/v1/buckets/BUCKET_ID/objects?kind=archive", {
  method: "GET",
  headers,
});
console.log(await res.json());
{
  "object": "list",
  "data": [
    {
      "object": "object",
      "id": "cbo_m2n8b4v6c1x9z3l7k5j0",
      "bucket_id": "cbk_q7c1r9t2y6u0i3o8p5a4",
      "kind": "archive",
      "name": "storefront.zip",
      "target_path": "",
      "content_type": "application/zip",
      "size": 131204115,
      "chunk_size": 16777216,
      "chunk_count": 8,
      "status": "ready",
      "preview": {
        "status": "partial",
        "files": 1284,
        "skipped": 3,
        "skipped_examples": [
          {
            "path": "assets/hero.mp4",
            "reason": "large file (kept in the archive)"
          }
        ],
        "stripped_folder": "storefront-main",
        "ms": 4180
      },
      "visibility": "inherit",
      "effective_visibility": "private",
      "public_url": null,
      "served_as": "file",
      "encrypted": true,
      "created_at": "2026-10-28T14:05:11.482Z",
      "completed_at": "2026-10-28T14:06:40.019Z"
    }
  ],
  "has_more": false
}