The official Python client for the SpatioAPI. Notes, sheets, slides, tasks, mail, calendar, channels, DMs, files, contacts, repos, agents, and federated search.
pip install spatio-sdkfrom spatio import ApiClient, Configuration
from spatio.api import NotesApi
client = ApiClient(Configuration(
host="https://api.spatio.app",
access_token="pat_...",
))
envelope = NotesApi(client).list_notes()
print(envelope.items)Two paths.
Personal Access Token. Mint one at Settings → Tokens in Spatio Desktop and pass it as access_token. 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 Authlib, oidcrp, and every other conformant RP library.
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.
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.