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
| Name | In | Type | Description |
|---|---|---|---|
bucket_id | path | string · required | |
limit | query | integer | |
cursor | query | string |
Responses
| Status | Description | Body |
|---|---|---|
200 | Page of objects | StorageObjectPage |
401 | Key missing or invalid | Error |
403 | scope_missing (storage:read) | Error |
400 | query_invalid, storage_page_limit_invalid, storage_cursor_invalid | Error |
404 | storage_bucket_not_found, not_found | Error |
503 | storage_temporarily_unavailable | Error |
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>")