SeleStorage

SeleStorage

Zero egress fees on downloads, on every plan. Fair use applies, and request and operation limits still apply. See pricing.

The host below is a placeholder; use the host shown in your developer console.

SeleStorage stores files for your app behind a simple HTTPS API. Each account's files are isolated from every other account, and you only ever use a SeleTech API key.

Quickstart

1. Create an API key in the console (shown once; copy it immediately).
2. Upload a file, read it back, list, delete.

curl

export KEY=ssk_test_xxxxxxxxxxxxxxxxxxxxxxxx
export HOST=https://storage.example.invalid   # placeholder until launch

curl -X PUT  "$HOST/v1/objects/hello.txt" -H "Authorization: Bearer $KEY" -H "Content-Type: text/plain" --data-binary "hello"
curl         "$HOST/v1/objects/hello.txt" -H "Authorization: Bearer $KEY"
curl         "$HOST/v1/objects?prefix=he"  -H "Authorization: Bearer $KEY"
curl -X DELETE "$HOST/v1/objects/hello.txt" -H "Authorization: Bearer $KEY"

TypeScript

const host = 'https://storage.example.invalid'; // placeholder until launch
const headers = { Authorization: `Bearer ${process.env.SELESTORAGE_KEY}` };

const body = new TextEncoder().encode('hello');
await fetch(`${host}/v1/objects/hello.txt`, { method: 'PUT', headers: { ...headers, 'Content-Type': 'text/plain', 'Content-Length': String(body.length) }, body });
const text = await (await fetch(`${host}/v1/objects/hello.txt`, { headers })).text();
const { objects } = await (await fetch(`${host}/v1/objects?prefix=he`, { headers })).json();

Authentication

Send Authorization: Bearer <key>. Keys start with ssk_live_ or ssk_test_. Test keys see a separate sandbox area and never touch live files. We store only a hash of each key, so a lost key cannot be recovered: create a new one. Each key has scopes: read, write and admin (admin includes the others and can create, rotate and revoke keys). Revoking a key or suspending an account takes effect on the very next request. Keep keys on your server; never put them in a mobile app or web page. Use signed URLs for those.

Endpoints

Object keys use / as a folder separator, up to 1024 characters. Keys with .., empty segments, backslashes or a leading / are rejected.

Pricing and egress

Zero egress fees on downloads, on every plan. Downloading your files never costs extra. This is subject to fair use, and request and operation limits still apply (see Limits).

Limits

Limits are hard stops: when you reach one, requests that would exceed it fail with 429 quota_exceeded until the next month or a plan change. We never bill silently past a limit. Plans and prices are provisional: see Pricing.

Errors

Errors are JSON: {"error":{"code":"...","message":"..."}}.