Admin
The org account, for the workspace's admins. Open /admin on the web, or the Admin button at the top of Settings. It opens on People.
Pages
Settings is about you. Admin is about the org. Devices and Connected agents appear on both: Settings shows yours, Admin shows the org's.
The sidebar holds six groups, each with its own pages. Fold a group with its chevron; the fold stays on this device. On a phone the sidebar is one picker.
| Group | Page | Address | Holds | Changes |
|---|---|---|---|---|
| Workspace | General | /admin/general | Plan, Workspace (mail and calendar, workspace defaults) and Setup checklist | the plan, where mail and calendar live, the defaults, the checklist |
| Branding | /admin/branding | Branding: name, accent, mark and backgrounds | the same | |
| Home and modules | /admin/home | work modules and the visitor home | the same | |
| Booking | /admin/booking | Booking NDA | pick or remove the document | |
| Members | People | /admin, /admin/people | the human roster | visibility, role, access, devices; hide, restore, revoke; sign a device out |
| Invitations | /admin/invitations | Invite and the open and lapsed invitations | invite, resend, revoke | |
| Agents | /admin/agents | enrollments, each agent's identity avatar, plus the last 30 days of handoffs, runtime acceptance or refusal, finalized replies observed by Starlings, delivery issues, watchdog reset outcomes, each configured endpoint's origin, and whether it is frozen, when and by whom | approve, freeze, unfreeze | |
| Organizations | /admin/organizations | peer organizations | the same | |
| Records | Contacts and leads | /admin/records | lead and contact characteristics and contact sources. Until contacts and leads move to Starlings, this page is read-only | add, rename, delete; a source's label and flags |
| Commercial | /admin/commercial | payment terms, currencies, corporate entities, delivery conditions, offer links and policies, once offers answer from Starlings | a setting's fields. A currency is turned off, not deleted | |
| Integrations | Connectors | /admin/connectors | the available sources: Granola where the workspace has it, GitHub, Slack and the Mac recorder; each card opens its page at /admin/connectors/<source> | mappings, Sync now, backfill |
| Monitoring | Overview | /admin/operations | Now (rooms in session, people connected and waiting) and Failures: what the Worker counted about itself in the last seven days (refused signatures, Core's events gone quiet, a route answering 5xx, a deploy check that could not run) | read-only |
| Meetings | /admin/meetings | the meetings hosted, the funnel and health | regenerate a meeting's notes | |
| Usage | /admin/usage | This month: LiveKit participant-minutes and measured downstream RTP receive bytes with the latest client-report time; Thresholds; and, for org admins, model calls and tokens per day | read-only | |
| System | /admin/system | the environment rows from the deploy | read-only | |
| Logs | Admin changes | /admin/changes | each admin change, with who and when | read-only |
| Record activity | /admin/activity | each change to a contact, organization, lead, project, task, goal, decision or call stored in Starlings, with who made it, the fields and when. Filter by text, record type, action, person and dates. Only org admins can open it | read-only | |
| Connector calls | /admin/connector-calls | every MCP call, with client, tool, outcome and whether a retry replayed its first result | read-only | |
| Jobs | /admin/jobs | the one-off admin actions, each with what it touches and when it last ran | the jobs themselves |
Only an admin of the workspace can open these pages. A member sees no Admin button, and the pages refuse a member.
Workspace defaults
In General → Workspace, an admin chooses the time-zone presets, languages offered and default language, contact and privacy addresses, AI filing persona, the name of the workspace's own project group, public events feed, and booking slot grid. The choices are saved in the workspace and audited. Calendar and Work read them on web, Mac and iPhone; an open web page uses them on its next load, and the native apps refresh their workspace descriptor. Interface language changes apply on reload or the next native launch. Personal language choices win when that language remains offered. The personal Language picker remains parked under the current localization policy.
A saved personal booking grid wins over the workspace fallback. Existing
workspaces keep their current values until an admin saves. An empty project
group name uses the workspace name, and an empty persona uses that workspace's
identity. An empty events feed turns off the public feed and clears previously
cached events on the clients' next refresh. New D1 workspaces
start without Envisioning's feed. A configured feed is a public HTTPS JSON
endpoint with the existing public-event projection (events array); it
receives only startDate and endDate, without credentials or redirects.
Private host-event reads and booking day closures retain their existing scope.
After defaults are saved, the workspace's /privacy page publishes its own
privacy and contact addresses and links to the product data policy. An unsaved
workspace keeps its existing redirect. Outbound workspace mail uses its contact
address for replies unless that message supplies a specific reply address.
The monthly downstream figure is the sum of RTP media bytes received by browser, Mac and iOS clients. Clients report about once a minute, and Admin refreshes automatically. It shows observed bytes only: it has no plan cap or projection, omits data-channel and transport overhead, may miss clients that have not reported, and can differ from LiveKit's billed total.
Plan
/admin/general shows the workspace's plan: Free, Starter or Pro. A workspace
with no plan set is on Pro. Free holds one project, in any status. Only an
Envisioning root admin changes the plan. When a move to Free leaves more than
one project, every project but one is read-only; an org admin picks the one
that stays writable, once. Until then it is the most recently updated project.
Invitations
On Invitations, Invite takes one or more addresses and a role, Member or Admin. Each address gets a mail from the workspace with the sign-in link. An invitation is open for 14 days. Open and lapsed invitations show under the form: Resend mails it again and opens it for another 14 days; Revoke closes it. Only an admin sees this card.
The invited person signs in with Google or a mailed link, as that address. They join with the invited role and their own room. An address on the workspace's sign-in domains needs no invitation. Any other address needs one; without it, or with a revoked or lapsed one, sign-in is refused. An address that is already a member, revoked or an agent is not invited.
Workspace backgrounds
On Branding, Backgrounds offers derived tones from the workspace accent or six explicit colours (base and pattern for Dark, Accent and Bright). The nine previews show Pixels, Flock and Grid in each tone. Invisible pattern colours are refused. With no accent or explicit tones, Envisioning keeps Night, Lime and Ice.
Upload or replace one workspace picture (PNG, JPEG or WebP, up to 12 MB). The browser resizes it to 1280 × 720 and removes metadata before sending it. This picture is public branding in the workspace's file storage. Remove deletes it and clears an image default. Personal camera pictures remain on the device.
Default background offers no default, any gallery entry, or the uploaded workspace picture. Members and guests read these choices from the workspace descriptor on web, Mac and iOS. A person's saved choice, including Off, always wins.
Setup checklist
On General, Setup checklist shows or hides the setup steps on everyone's Home. The card's own Turn off for everyone clears the same box. See [Set up your workspace](../howto/set-up-your-workspace.md).
Booking NDA
On Booking, Booking NDA picks a document from Docs. Every booking page on the workspace then offers Meet under NDA. A guest who ticks it gets the document by email to sign, through Docs. Docs keeps the signature and its certificate. Remove clears it. A workspace without Docs does not show it.
Controls
| Control | Does | Surface |
|---|---|---|
| Tone colours | Derive from workspace accent or Set each colour | web Admin |
| Base colour / Pattern colour | Set the six colours; previews update as you type | web Admin |
| Default background | Choose the initial camera background for someone without a saved choice | web Admin |
| Save backgrounds | Save the palette and default | web Admin |
| Workspace picture | Preview the public picture; Upload…, Replace… or Remove | web Admin |
Freezing an agent
Freeze on /admin/agents stops one agent from its next call, with no
deploy. A frozen agent gets no messages, cannot read Starlings and cannot post.
A person who writes to it sees a quiet line in the conversation saying it is
frozen. Unfreeze lets it back in. Admin's trail records who did each.
Leads to
A meeting's transcript; a person in team.
Verified · docs/help/surfaces/admin.md