Integrate your product
PARALYN is your AI interface layer: your users sign in with the same accounts from your app, your backend supplies data and actions, and we host the workspace UI.
1. Register a workspace
One tenant, one workspace slug, one handoff secret (shown once).
POST /api/tenants/register with Authorization: Bearer $PARALYN_TENANT_ADMIN_TOKEN
Or run: paralyn tenant register --slug acme --tenant acme
2. Hand off signed-in users
After login in your app, sign a short-lived handoff JWT and redirect to Platform.
Use @paralyn/identity signHandoffToken on your server, then createPlatformHandoffUrl.
Users land on /auth/handoff and enter the correct workspace as user, admin, or developer.
3. Deploy manifest & backend webhooks
Permissions and action definitions for your workspace.
paralyn manifest compile --config paralyn.config.json --out manifest.json
paralyn deploy upload --workspace acme --in manifest.json
Set backendBaseUrl on register. On confirm, PARALYN POSTs to /paralyn/webhooks/actionsand to each action's endpoint from the manifest (both HMAC-signed with your handoff secret).
Platform sessions are PARALYN-issued after handoff (httpOnly cookies on paralynhq-ai.vercel.app) — no separate PARALYN password.
4. Embed or go full Platform
Same gateway, two surfaces.
Embed: @paralyn/sdk widget with a session JWT from POST /api/auth/scoped-session (limit to specific manifest actions) or POST /api/auth/session.
Full UI: handoff to paralynhq-ai.vercel.app — user, admin, and dev workspaces with your manifest permissions.