# Galon Storage > Buckets and files for your project: direct uploads, signed links, public buckets, versions and usage, paid from your prepaid balance. Server side only: read the key from the `GALON_API_KEY` environment variable. Call `GET https://api.galon.ai/v1/tools` first: use only what it lists for this key. Send an `Idempotency-Key` with every write and reuse it on retry. On an error, act on `detail.code` and follow `detail.next_action`. ## What it does - Create buckets and upload files with a native HTTP API (not S3-compatible): the bytes go to a short-lived upload capability, not through the JSON API. - Share a file with a signed link that expires, or serve a bucket publicly after an explicit confirmation. - Object versions and restore, usage and usage history. - Storage is paid per GB-month from the prepaid balance; files are stored in Paris (EU) and stay readable for a grace period when the balance runs out. ## API - `GET /v1/storage/buckets`: List buckets - `POST /v1/storage/buckets`: Create a bucket - `GET /v1/storage/buckets/{bucket_id}`: Read a bucket - `POST /v1/storage/buckets/{bucket_id}/uploads`: Start an upload - `POST /v1/storage/uploads/{upload_id}/commit`: Finish an upload - `GET /v1/storage/buckets/{bucket_id}/objects`: List files - `GET /v1/storage/objects/{object_id}`: Read a file - `DELETE /v1/storage/objects/{object_id}`: Delete a file - `GET /v1/storage/usage`: Storage usage - `GET /v1/storage/objects/{object_id}/versions`: List an object's versions - `POST /v1/storage/objects/{object_id}/restore`: Restore an earlier version - `POST /v1/storage/objects/{object_id}/links`: Create a time-limited signed link - `GET /v1/storage/usage/history`: Get Storage usage history - `GET /v1/storage/tier`: Get the project's Storage tier - `PUT /v1/storage/tier`: Change Storage tier - `GET /v1/storage/buckets/{bucket_id}/access`: Get a bucket's public access - `PUT /v1/storage/buckets/{bucket_id}/access`: Make a bucket public or private ## MCP tools Server: `https://api.galon.ai/v1/mcp` (Streamable HTTP). - `list_buckets`: List the storage buckets of this project. - `create_bucket`: Create a storage bucket. - `get_bucket`: Read a storage bucket. - `list_objects`: List the files of a bucket. - `get_object`: Read a file's metadata. - `start_upload`: Reserve a file and get a one-time upload address (PUT the bytes there). - `commit_upload`: Confirm an upload once the bytes are sent. - `delete_object`: Delete a file from its bucket. - `get_storage_usage`: Stored bytes and file count of this project. ## Docs - [Galon Storage guide](/cloud/docs/services/storage) - [OpenAPI 3.1 contract](/cloud/docs/openapi.json): the source of truth for routes and fields - [Complete LLM integration guide](/llms-full.txt)