Galon Cloud
Galon API v1

/storage/objects/{object_id}

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

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

NameInTypeDescription
object_idpathstring · required

Responses

StatusDescriptionBody
200ObjectStorageObject
401Key missing or invalidError
403scope_missing (storage:read)Error
404storage_object_not_found, not_foundError
503storage_temporarily_unavailableError

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

NameInTypeDescription
object_idpathstring · required

Responses

StatusDescriptionBody
202Deletion queuedStorageObjectDeletion
200Idempotent replayStorageObjectDeletion
400body_not_allowedError
401Key missing or invalidError
403scope_missing (storage:write)Error
404storage_object_not_found, not_foundError
503storage_operation_indeterminate: replayError

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>")