Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.7331.org/llms.txt

Use this file to discover all available pages before exploring further.

​
What is Portal?

Portal is a real-time collaboration platform built around shared virtual browsers. Users co-browse any site together, chat end-to-end encrypted alongside it, and — when they want to meet someone new — get matched 1-on-1 with another user online. Every chat is its own chat channel. Messages are encrypted with nacl.secretbox using a chat key that rotates per epoch; the server only ever sees opaque ciphertext.

​
The three surfaces

Co-browsing

Multi-user neko containers (Brave, Tor) spawned on demand. Host/guest control handoff, clipboard sync, screenshot export.

E2EE chat

Per-chat secretbox encryption with epoch-rotated keys. Wipe/kick triggers epoch rotation; the server cannot read history.

1-on-1 match

Anonymous 1-on-1 matchmaking. Enqueue on an interest tag, get paired into an ephemeral direct chat, leave cleanly or let the 60s grace expire.

​
Base URLs

REST       https://portal-api.7331.org
WebSocket  https://portal-ws.7331.org
Frontend   https://portal.7331.org

​
Authentication

Three methods, never combined on the same endpoint:
  • Session cookie (psession) — web users after login via platform-delivered OTP
  • Bot API key (X-API-Key) — registered bot instances
  • Public API key (X-API-Key) — statistics and read-only browsing
See Authentication for the OTP flow and key handling.

​
For community operators

Portal keeps its bot-integration surface for communities that want to manage users, subscriptions, and punishments programmatically.

Bot & admin APIs

Registering bots, granting subscriptions, issuing punishments, audit logs.

Quickstart

Log in and open your first chat.

API Reference

Every endpoint, grouped by surface.