Alright terminal nerds, C-Mail in the API, finally. Load up your TUIs!

Let me know if it works properly. Debug on prod, obviously. Once we know it does I can do cIRC.

Cyberspace API 0.6.0

• Auth

  • POST /v1/auth/login and /v1/auth/refresh now also return rtdbUrl (the Realtime Database endpoint, a non-secret URL) so clients can read C-Mail in real time using their existing idToken.

• C-Mail

  • New REST surface for C-Mail (private 1:1 messaging), backed by Realtime Database. Sending goes through the API (content sanitized, sender identity set server-side, rate-limited); live reading is done by subscribing to RTDB directly — the idToken works as the database auth, so no Firebase API key or token exchange is needed.
  • Endpoints: POST /v1/cmail (start or get a conversation by recipient username/id — the API derives the conversation id for you), GET /v1/cmail (list conversations, unread/newest first), GET /v1/cmail/:conversationId (read a conversation, paginated), POST /v1/cmail/:conversationId (send), POST /v1/cmail/:conversationId/read (clear unread).

• Rate limits: messages 15/min, 150/hour, 300/day; new conversations 5/min, 30/hour, 50/day.

Holler at @ragnar @7spires

If you want API access you should become a supporter (=ↀ益ↀ=)