Teams, roles & organizations
Every uniqOS account lives inside an organization. Signup creates a personal one; you can create more and invite teammates into any organization you own.
Roles
| Role | Can do |
|---|---|
owner | Everything, including billing, deletion, and ownership transfer |
admin | Everything except ownership transfer and org deletion |
developer | Create/manage personalities, API keys, end-user data — no billing writes |
viewer | Read-only across the account |
Inviting members
POST /v1/organizations/{id}/members/invitations
emails an invite link (7-day TTL). The invitee opens it, signs in (or up), and accepts —
they join with the role you chose. Pending invitations can be listed and revoked.
Switching organizations
Access tokens are scoped to one organization. To work in another one you belong to, call
POST /v1/me/switch-organization — it returns a
new access token for the target organization and keeps your refresh session pointed at
it. The portal's organization selector does this for you.
Ownership transfer
Owners can hand an organization to another member: the transfer is initiated, the current owner confirms via an emailed link, and the swap is atomic. The previous owner becomes an admin.