Skip to main content
The Storage primitive is object storage (buckets + files), backed by a fullstack app’s Supabase project. Naive injects the project’s service-role key and proxies the Supabase Storage API (/storage/v1).
Requires a fullstack app (naive.apps.create({ name, type: "fullstack" })). Like Database/Functions/Auth, it’s a curated surface over the app-scoped Supabase proxy.

​
Two ways to use it

// Your own project (default user)
await naive.storage.listBuckets();

// A specific end-user's project
await naive.forUser(alice.id).storage.listBuckets();
Omit { appId } to auto-resolve the user’s single fullstack app; pass it when they own several.

​
Buckets

await naive.storage.createBucket("avatars", { public: true });
await naive.storage.listBuckets();
await naive.storage.getBucket("avatars");
await naive.storage.deleteBucket("avatars");

​
Objects

// List objects under a prefix
await naive.storage.list("avatars", { prefix: "users/" });

// Upload text/JSON content
await naive.storage.upload("avatars", "users/alice.json", { name: "Alice" });

// Download + remove
await naive.storage.download("avatars", "users/alice.json");
await naive.storage.remove("avatars", ["users/alice.json"]);
Binary uploads (images, video) are best done with a Supabase signed upload URL rather than the JSON proxy. Request one via the Supabase proxy (POST .../storage/v1/object/upload/sign/{bucket}/{path}) and PUT the bytes directly.

​
REST

curl https://api.usenaive.ai/v1/apps/<app-id>/storage/proxy/bucket \
  -H "Authorization: Bearer nv_sk_live_..."
Your own project uses /v1/apps/<app-id>/…; an end-user’s project uses /v1/users/<user-id>/apps/<app-id>/…. Everything under storage/proxy/* forwards to the project’s /storage/v1/*. See the Storage API reference.

​
Billing

Free — no per-operation credit cost. Account Kits can gate the storage primitive per user.