spatio-sdk 0.0.2

Python SDK for the SpatioAPI. Generated from the official OpenAPI spec.

Spatio Python SDK

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-sdk

from 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)

Authentication

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.

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.