Public API v1 — remote text filesystem

Every note is a file. Build agents, automations, and alternative editors over HTTP with a txt_ key. Local editing needs no account; dots sign-in unlocks sync + API access.

Open interactive playground →

agent memory

Read workspace context, write research, create plans, and connect related notes.

group skills

Publish Claude and Codex SKILL.md trees into a shared folder teammates can pull.

automation

Capture meetings, email, forms, logs, release notes, and generated reports.

collaboration

Let bots leave comments and suggestions instead of silently overwriting text.

custom clients

Build terminal, mobile, publishing, and knowledge tools on one text filesystem.

FILESYSTEM VERBS

discover GET    /api/v1
list     GET    /api/v1/files?limit=50
read     GET    /api/v1/files/:id
raw      GET    /api/v1/files/:id/raw
write    PUT    /api/v1/files/:id
create   POST   /api/v1/files
upload   POST   /api/v1/files/upload?name=FILE
import   POST   /api/v1/files/import
download GET    /api/v1/files/:id/raw
temp-url POST   /api/v1/files/:id/share
users    GET    /api/v1/identities
use      PATCH  /api/v1/identities
ideate   POST   /api/v1/ideation
grow     POST   /api/v1/files/:id/ideate
render   POST   /api/v1/artifacts
models   GET    /api/v1/artifacts/models
scan     POST   /api/v1/transcriptions
unlink   DELETE /api/v1/files/:id
readdir  GET    /api/v1/folders/:id
mkdir    POST   /api/v1/folders
comment  POST   /api/v1/files/:id/comments
suggest  POST   /api/v1/files/:id/suggestions
connect  POST   /api/v1/files/:id/connections
commit   POST   /api/v1/files/:id/versions
skills   GET    /api/v1/skills
share    POST   /api/v1/shares
folder   POST   /api/v1/folders/:id/share
changes  GET    /api/v1/changes?cursor=0
batch    POST   /api/v1/batch
sync     POST   /api/v1/sync
events   POST   /api/v1/webhooks
device   POST   /api/v1/devices
pin      PUT    /api/v1/devices/:id/state

Full-client sync uses a durable cursor feed with delete tombstones and ordered batch writes. Devices register once and carry per-file availability—online-only, available, or pinned—Dropbox-style, per device. Single-file polls honor If-None-Match → 304 when unchanged. Listings never include file bodies. Writes support If-Match, and retryable mutations support Idempotency-Key.

INTEGRATE

Mint a key at /sync (sign in with dots once).
Paste TXT_BASE_URL and TXT_API_KEY into your app.
Point agents at /llms.txt for the full integrate cookbook.

curl $${TXT_BASE_URL}/api/v1/files?limit=50 \
  -H "Authorization: Bearer $${TXT_API_KEY}"

Keys can be scoped, set to expire, rotated, and revoked. v1 responses include request IDs and rate-limit headers; browser clients receive CORS headers.

THEMES

GET /api/v1/theme resolves your account default. Add one of fileId, folderId, or groupId for a scoped theme. PUT saves themeId, overrides, and the current revision. Folder and group settings require ownership.

Theme settings · Token schema

Back to editor