Collaborators
Giving a named person access to one agent, without giving them the rest of the workspace.
A collaborator is a workspace member whose access is limited to chosen agents. A member with full access reaches every agent the workspace owns. When someone needs one agent and nothing else, invite them from workspace Members and set Access to that agent only. The agent's Access page, under its Settings, lists who can open it.
Three ways people reach an agent:
- Workspace members see every agent, plus numbers, billing and settings as their role allows.
- Collaborators reach only the agents they were given, with an account. They don't use a seat.
- Share links let anyone with the URL talk to the agent: no account, no access to settings.
Access levels
A collaborator's role decides what they can do on their agents. They join as an Editor. To make them read-only, change their role to Viewer.
| Role | Can do |
|---|---|
| Viewer | Read settings, calls and results. |
| Editor | The above, plus changing, testing and publishing the agent. |
sam@example.com Viewer reads settings, calls and results
dev@agency.com Editor also changes settingsWhat an edit collaborator cannot do
An edit collaborator cannot change:
- Lifecycle. Archiving, restoring, deleting or deactivating the agent.
- Public exposure. The agent's share link or slug.
- Governance. Data retention, PII redaction and telemetry content level.
These limits are enforced in the database, so they hold on every route into the agent, not just the UI. An edit collaborator can still publish a new version and create a website key; give them the Viewer role if they shouldn't. See access control for how enforcement is built.
A collaborator also cannot add, remove or change anyone's access. They can see the agent's Access page, which lists who can open the agent, but not the workspace's member list.
Collaborators versus workspace members
| Collaborator | Workspace member | |
|---|---|---|
| Reach | The agents they were given | Every agent in the workspace |
| Sees the workspace nav | No, only Agents and Conversations for their agents | Yes |
| Numbers, billing, settings | No | Governed by their role |
| Can archive or delete the agent | No | With an editing role |
| Can mint or revoke a share link | No | With an editing role |
| Can manage collaborators | No | Owners and admins |
Where a collaborator lands
A collaborator with exactly one agent lands straight on that agent when they sign in. With more than one, they get a list of just those agents.
Inviting someone
In workspace Members, choose Invite members, enter their email address and set Access to the agents they should open.
- If they already have an account, access is live immediately.
- If they do not, they are emailed a link to claim access. They set a password or sign in, and the access binds to the account they end up with. Until then the row shows as Invited. The link expires after seven days.
Existing members are refused
If the email already belongs to a member of the workspace, the invitation is refused. To change which agents that person reaches, use Agent access on their row instead.
Removing access
Remove the person from workspace Members. Access ends at once.
Changing someone between Viewer and Editor, or changing their agents with Agent access, takes effect immediately, with no re-invitation.