GET /storage/objects/{object_id}
Get an object's metadata
Exact scope storage:read. Metadata only, never the content. 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 |
|---|---|---|---|
object_id | path | string · required |
Responses
| Status | Description | Body |
|---|---|---|
200 | Object | StorageObject |
401 | Key missing or invalid | Error |
403 | scope_missing (storage:read) | Error |
404 | storage_object_not_found, not_found | Error |
503 | storage_temporarily_unavailable | Error |
Examples
curl
curl -X GET "$GALON_API_BASE/storage/objects/<object_id>" \
-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.objects.get("<id>");Python (SDK)
from galon import Galon
galon = Galon() # reads GALON_API_KEY
result = galon.objects.get("<id>")DELETE /storage/objects/{object_id}
Request deletion of an object
Exact scope storage:write. Idempotent, no body: 202 on the first request, 200 on subsequent ones with the same job. The object moves to 'deleting' and stays listed until purged; its volume remains counted in committed_bytes (and pending_deletion_bytes) until then. 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 |
|---|---|---|---|
object_id | path | string · required |
Responses
| Status | Description | Body |
|---|---|---|
202 | Deletion queued | StorageObjectDeletion |
200 | Idempotent replay | StorageObjectDeletion |
400 | body_not_allowed | Error |
401 | Key missing or invalid | Error |
403 | scope_missing (storage:write) | Error |
404 | storage_object_not_found, not_found | Error |
503 | storage_operation_indeterminate: replay | Error |
Examples
curl
curl -X DELETE "$GALON_API_BASE/storage/objects/<object_id>" \
-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.objects.remove("<id>");Python (SDK)
from galon import Galon
galon = Galon() # reads GALON_API_KEY
result = galon.objects.remove("<id>")