Access and upkeep

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.

RoleCan do
ViewerRead settings, calls and results.
EditorThe above, plus changing, testing and publishing the agent.
sam@example.com    Viewer    reads settings, calls and results
dev@agency.com     Editor    also changes settings

What 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

CollaboratorWorkspace member
ReachThe agents they were givenEvery agent in the workspace
Sees the workspace navNo, only Agents and Conversations for their agentsYes
Numbers, billing, settingsNoGoverned by their role
Can archive or delete the agentNoWith an editing role
Can mint or revoke a share linkNoWith an editing role
Can manage collaboratorsNoOwners 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.

On this page