API v2 · stable · ap.clikkin.com
Clikkin is an open ecosystem. Build a third-party client, ship a Space App, sell a theme, or fork the protocol entirely — our docs treat all four as first-class citizens.
# Install the SDK $ npm install @clikkin/sdk # Authenticate with a scoped token import { Clikkin } from '@clikkin/sdk'; const cl = new Clikkin({ token: process.env.CLIKKIN_TOKEN, space: '@maker.garage', }); # Post to your space await cl.posts.create({ body: 'Hello from the open web 👋', audience: 'members', }); ✓ Posted · ID cl_01HT9...
Four developer surfaces
S1
Read and write posts, media, reactions, DMs, spaces, and members. Scoped tokens, per-space rate limits, full CORS support.
Docs →S2
Embedded mini-apps that run inside a space. Polls, booking, leaderboards, custom dashboards. Sandboxed, signed, installable in one click.
Build a Space App →S3
Build an entirely new client on top of the protocol. No gatekeeping — just implement the spec. We publish conformance tests and a reference client.
Protocol spec →S4
Distribute paid themes, starter templates, and badge packs in the Clikkin Store. 80/20 split. Admins install in one tap.
Vendor kit →Quickstarts
Each quickstart is a single-file demo with copy-pasteable code and a sandbox you can fork.
Open protocol
Clikkin is an implementation of an open protocol. The wire format, identity layer, and federation rules are published and versioned. If Clikkin disappeared tomorrow, someone else could run it — or you could.
PROTOCOL-v2.0.3
StableEnvelope ::= SEQUENCE { version INTEGER, sender Identity, audience Audience, timestamp UtcTime, payload OCTET STRING, signature Ed25519Sig } -- Signatures are verified at each hop. -- Envelopes are content-addressed by -- BLAKE3(canonical_cbor(body)).
In the wild
A terminal-first Clikkin client with a tiling UI and keyboard-only workflow. Vim bindings, 0 dependencies.
Lightweight polling and ranked-choice voting for spaces. Used in 600+ spaces for governance votes.
A print-inspired theme with Linotype-style headings and generous margins. Pairs well with writing-focused spaces.
Post Figma changes to a design space as threaded updates. Attaches frames as inline media.
Declarative bot framework for Space Apps. YAML-configurable, deploys to Cloudflare Workers in one command.
Two-way bridge between Clikkin spaces and Mastodon instances. Maintains thread identity across protocols.
Rate limits
| Unauthenticated | 60 req / min |
| Authenticated (member) | 600 req / min |
| Authenticated (space bot) | 3,000 req / min |
| Bulk export | soft-metered |
Every response includes X-RateLimit-Remaining and X-RateLimit-Reset. Bursts up to 2x for short windows.
Sandbox
Your sandbox space is provisioned at signup — real API, real webhooks, synthetic members. Spin up test data with one command:
$ clikkin sandbox seed \
--members 50 \
--posts 400 \
--over 7days
Sandbox docs →
Deprecation
When we deprecate an endpoint — rare — we commit to at least 12 months of parallel support, with monthly email reminders. Every deprecation goes through the RFC process first.
No surprise deprecations in the last 18 months. Track the feed: /changelog.atom.
Developer programs
$1M/yr in grants and infrastructure credits for open-source Space Apps, clients, and bridges. Rolling applications.
Apply →Get protocol RFCs, SDK betas, and API changes 60 days before general availability. Quarterly office hours with the core team.
Join →Sell themes, templates, and badge packs in the Clikkin Store. 80/20 revenue split. We handle tax, fraud, and refunds.
Become a vendor →Up to $10,000 for qualifying reports. Hall of Fame. PGP: 0x8E1D4A2F.
Need help?
Core engineers rotate through developer support. Median response: 2 hours in the dev Discord, 6 hours on the forum, 24 hours via email.