Spatio TypeScript SDK

The official TypeScript client for the SpatioAPI. Notes, sheets, slides, tasks, mail, calendar, channels, DMs, files, contacts, repos, agents, and federated search. From any Node, Bun, Deno, or browser runtime.

npm install @spatio-labs/spatio-ts

import { Configuration, NotesApi } from "@spatio-labs/spatio-ts";

const notes = new NotesApi(
  new Configuration({
    basePath: "https://api.spatio.app",
    accessToken: process.env.SPATIO_PAT,
  }),
);

const envelope = await notes.listNotes();
console.log(envelope.items);

Authentication

Two paths.

Personal Access Token. Mint one at Settings → Tokens in Spatio Desktop and pass it as accessToken. The right choice for scripts, automations, and your own backend services.

OAuth 2.1 + OpenID Connect. Build a "Sign in with Spatio" flow for your own product. The OIDC discovery document at /.well-known/openid-configuration drops into NextAuth, Auth.js, oidc-client-ts, passport-openidconnect, and every other conformant RP library.

What you can build

Spatio's API is designed to be the substrate someone could build their own Spatio Desktop on top of: realtime collaboration via Yjs, federated cross-platform search, OAuth 2.1 dynamic client registration, OpenID Connect sign-in, and a self-hosted agent runtime. The OpenAPI spec is the canonical reference.

Links

• SpatioAPI reference
• OpenAPI spec
• Spatio on the web

About this package

Generated from the SpatioAPI OpenAPI spec on every release. PRs against generated files will be overwritten on the next release; file issues here for bugs in the SDK shape, or report API problems through Spatio Support.

Licensed under MIT.