Spaces for Developers

Build Spaces into whatever you’re making.

Spaces looks after the files a studio lives on — the photographs, the cuts, the brand assets, the years of work. Now there’s a clean, scoped API so the rest of your stack can reach in and use them: read a folder, push a render, mint a share link, search the whole library. Connect it to your own apps, your clients’ portals, or the other tools you already run.

Many wonderful ways to use it

Wire your tools together

Drop finished work into the right Area automatically — straight from your project manager, your render farm, or the card you just offloaded. No more end-of-day dragging.

Build a client portal

Back a branded gallery or a delivery page on your own site with files that live in Spaces, served through short-lived signed links. Your design, our storage.

Automate the boring

When a file lands, ping a channel, kick off a workflow, or log it in your ops sheet. Subscribe to signed webhooks for the events you care about, or poll the change feed.

Feed your own pipelines

Pull files — and the search index that already understands them — into whatever you’re building, from a render queue to your own AI tooling.

One home for brand assets

Serve logos, fonts, and templates to your sites and apps from a single source of truth, so nobody’s ever working from last year’s mark again.

Dashboards that fit you

Surface storage, recent activity, and the latest uploads inside your own studio dashboard — the numbers you actually look at, where you look at them.

It starts with one token

Mint a scoped Personal Access Token in your workspace settings, grant it only what it needs — read files, write files, search — and call the API. Tokens carry exactly the access you give them and never more than the person who made them already has.

# List everything in an Area
curl https://your-workspace.vidualspaces.com/api/v1/files?area=brand \
  -H "Authorization: Bearer vsk_your_token_here"

# Get a short-lived download link for one file
curl "https://your-workspace.vidualspaces.com/api/v1/files/download\
?area=brand&key=logos/wordmark.svg&filename=wordmark.svg" \
  -H "Authorization: Bearer vsk_your_token_here"

Scopes: files:read, files:write, areas:read, shares:write, search:read, and more. Everything is versioned under /api/v1, so what you build today keeps working.

Or reach for the SDK

If you’re working in TypeScript or Node, the official SDK wraps all of this — tokens, uploads (it picks single-PUT or multipart for you), areas, shares, search, OAuth and webhooks — behind a handful of typed calls, so you can skip the plumbing and get straight to the part you actually wanted to build.

npm install @vidual/spaces

import { SpacesClient } from "@vidual/spaces";

const spaces = new SpacesClient({
  baseUrl: "https://your-workspace.vidualspaces.com",
  accessToken: process.env.SPACES_TOKEN, // vsk_…
});

// See where you can write, then push a file.
const areas = await spaces.areas.list();
await spaces.files.upload({
  area: "brand",
  key: "logos/wordmark.svg",
  data: bytes,
  contentType: "image/svg+xml",
});

Zero runtime dependencies, ships its own types, Node 18+. Read the full surface — OAuth, webhooks and Vidual Send included — on npmjs.com/package/@vidual/spaces.

What about Vidual Send?

Send is a slightly different animal — quick, accountless, here-then-gone transfers rather than a permanent home — so it gets its own small, key-based API rather than riding on a person’s Spaces login. The plan: fire off a Send transfer straight from your app, and let a recipient save what they’ve been sent into a Spaces Area in a click. The ephemeral front door and the permanent home, wired together. That one’s on the roadmap, not live yet — tell us if you’d use it and we’ll move it up.

Built with Spaces

We’re just opening the doors, so this wall is waiting for its first builds. If you make something with the API — a portal, an automation, a daft little side project — we’d love to see it. We’ll feature the ones we love right here, send people your way, and generally make a fuss. Consider it a standing invitation to show off.

Show us what you built

The API is in early access. Start a trial to get a workspace, then write to us and we’ll get you a token and walk you through it — we’re keen to build this with the people who’ll use it.

Start a trial Ask for early access