Galon Cloud
Galon API v1

/projects/{project_id}/storage/buckets

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

GET /projects/{project_id}/storage/buckets

Console — List the project's buckets

Galon console session: tenant from the session, project in the path verified as an active project of the tenant, project environment; admin role (a member receives 403 reserve_admin). Same control plane and same projection as the key-based route. Hidden surface: 404 not_found until the Galon Object opt-in is enabled.

Console session only (signed-in console).

Parameters

NameInTypeDescription
project_idpathstring · required
limitqueryinteger
cursorquerystring

Responses

StatusDescriptionBody
200Page of buckets, signed cursorStorageBucketPage
401unauthorized (session missing, expired or revoked)Error
403reserve_admin (member)Error
400query_invalid, storage_page_limit_invalid, storage_cursor_invalidError
404project_not_found, not_found (surface closed or tenant not admitted), Error
503storage_temporarily_unavailableError
422project_id_invalidError

Examples

curl

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

POST /projects/{project_id}/storage/buckets

Console — Create a bucket

Galon console session: tenant from the session, project in the path verified as an active project of the tenant, project environment; admin role (a member receives 403 reserve_admin). Same control plane and same projection as the key-based route. 201 on creation, 200 on replay of the same Idempotency-Key. Hidden surface: 404 not_found until the Galon Object opt-in is enabled.

Console session only (signed-in console).

Parameters

NameInTypeDescription
project_idpathstring · required
Idempotency-Keyheaderstring · required

Request body

application/json · schema StorageBucketCreate

FieldTypeDescription
namestring · required
placement"global" | "eu" | "africa-west" · required

Responses

StatusDescriptionBody
201Bucket createdStorageBucketReceipt
200Idempotent replayStorageBucketReceipt
400body_fields_invalid, body_invalid, storage_idempotency_key_invalidError
401unauthorized (session missing, expired or revoked)Error
403reserve_admin (member)Error
404project_not_found, not_found (surface closed or tenant not admitted), Error
409storage_idempotency_conflict, storage_bucket_existsError
413body_too_largeError
415content_type_invalidError
422project_id_invalid, storage_bucket_name_invalid, storage_placement_invalidError
429storage_bucket_quota_exceededError
503storage_temporarily_unavailable, storage_operation_indeterminateError

Examples

curl

curl -X POST "$GALON_API_BASE/projects/<project_id>/storage/buckets" \
  -H "Authorization: Bearer $GALON_API_KEY" \
  -H "Idempotency-Key: <unique-key>" \
  -H "Content-Type: application/json" \
  -d '{"name": "string", "placement": "global"}'