Clatter Labs
Console

Code Buckets

Get a project

View as Markdown

One project by its Project ID.

GETapi.codebuckets.clatterlabs.xyz/v1/projects/{project_id}buckets:read

Returns the project with its bucket count.

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

project_idstringrequired

The Project ID (cbp_…).

Response

200 · application/json

objectstring

Always project.

idstring

The Project ID, like cbp_4k9x2m7q1n8v3c6z0b5w. Stable for the life of the project.

project_idstring

Same as id, for convenience.

namestring

The project's name.

descriptionstring | null

Your description.

bucketsinteger

How many buckets the project has.

created_at / updated_atstring

ISO 8601 timestamps.

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 project with that id on your account.
curl "https://api.codebuckets.clatterlabs.xyz/v1/projects/PROJECT_ID" \
  -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/projects/PROJECT_ID", 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/projects/PROJECT_ID", {
  method: "GET",
  headers,
});
console.log(await res.json());
{
  "object": "project",
  "id": "cbp_4k9x2m7q1n8v3c6z0b5w",
  "project_id": "cbp_4k9x2m7q1n8v3c6z0b5w",
  "name": "storefront",
  "description": "Web shop and its assets",
  "buckets": 1,
  "created_at": "2026-10-28T14:05:11.482Z",
  "updated_at": "2026-10-28T14:05:11.482Z"
}