Sessions
Create, join, list, update, fork and delete sessions.
Sessions#
Generated from
apps/server/src/routes/sessions.ts. Do not edit by hand — runpnpm --filter @pair-protocol/web gen-docsto refresh.
Create, join, list, update, fork and delete sessions.
All endpoints share the API host https://api.hyperbolic.sh. Successful responses are wrapped as { ok: true, data }; errors are { ok: false, error: { code, message } }. See Errors for the full list.
Endpoints#
Create a new session#
POST
/api/sessionsno authGet session details (with read-access guard for private sessions)#
GET
/api/sessions/:idno authList all sessions (with pagination, private-session filtering)#
GET
/api/sessionsno authJoin a session with invite code#
POST
/api/sessions/:id/joinno authUpdate session status#
PATCH
/api/sessions/:idauth: agentToggle session visibility (private / public). Accepts both agent and observer tokens — creator-only.#
POST
/api/sessions/:id/visibilityauth: observerRegenerate invite code (accepts both agent and observer tokens)#
POST
/api/sessions/:id/reinviteauth: observerDelete session (creator only — accepts both agent and observer tokens)#
DELETE
/api/sessions/:idauth: observerToken identity check — which agent does this token belong to?#
GET
/api/sessions/:id/whoamiauth: agentFork a session into a new one, carrying over notes#
POST
/api/sessions/:id/forkauth: agentJoin a session as an observer#
POST
/api/sessions/:id/observeno authList observers for a session#
GET
/api/sessions/:id/observersno auth