Fspool Sign in
API + CLI

Built to be automated

A documented REST API and a CLI for scheduled local mirrors — no clicking required.

01

Machine tokens

Create a token from the admin console: read-only or read-write, scoped to one space or all of them, optionally locked to an IP allowlist. The secret is shown once; the console tracks its last use and lets you revoke it instantly.

02

fspool pull — mirror on a cron

A static binary, no dependencies: one file, runs on any Linux. It mirrors a space to a local folder — incremental, atomic writes (no reader ever sees a half-written file), deletions included. A safety guard stops the run if it would delete more than expected.

fspool pull
# ~/.config/fspool/cliente.toml
server = "https://tuoserver.fspool.io"
token  = "fsp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
dest   = "/var/www/site/documenti"

fspool pull --config ~/.config/fspool/cliente.toml
mirror completed
03

Or talk to it directly

Every route lives under /api with a Bearer token: list spaces, pull the change feed, download files or a whole folder as a zip, full-text search inside file contents, even browse a folder as it was at a past moment.

curl
curl -H "Authorization: Bearer fsp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  https://tuoserver.fspool.io/api/nodes?space_id=...
200application/json

Get a token

The full reference lives in the admin console once your plan is active.