Galon Cloud
Galon API v1

/storage/buckets/{bucket_id}/objects

Base URL https://api.galon.ai/v1 · export GALON_API_BASE="https://api.galon.ai/v1"

GET /storage/buckets/{bucket_id}/objects

List objects in a bucket

Exact scope storage:read. Committed objects, in commit order, signed cursor bound to the project and the bucket. Hidden surface: 404 not_found until the Galon Object opt-in is enabled and a qualified data plane is injected. No bytes pass through the API; no internal reference or provider name is returned.

API key (Bearer), on the public API endpoint.

Parameters

NameInTypeDescription
bucket_idpathstring · required
limitqueryinteger
cursorquerystring

Responses

StatusDescriptionBody
200Page of objectsStorageObjectPage
401Key missing or invalidError
403scope_missing (storage:read)Error
400query_invalid, storage_page_limit_invalid, storage_cursor_invalidError
404storage_bucket_not_found, not_foundError
503storage_temporarily_unavailableError

Examples

curl

curl -X GET "$GALON_API_BASE/storage/buckets/<bucket_id>/objects" \
  -H "Authorization: Bearer $GALON_API_KEY"

Node.js (SDK)

import { Galon } from "galon";

const galon = new Galon(process.env.GALON_API_KEY);
const result = await galon.buckets.objects("<id>");

Python (SDK)

from galon import Galon

galon = Galon()  # reads GALON_API_KEY
result = galon.buckets.objects("<id>")