- Roles decide who may administer Conduit — configure providers, manage people, create connectors, read audit logs.
- Access policies decide which connectors and tools each person’s AI client may use.
Roles
Instance roles
Every user is either a user or an instance admin. Instance admins operate the deployment: sign-in policy and identity providers, email and telemetry configuration, MCP client management, user and workspace administration, instance-wide usage and audit. Instance admins pass every workspace-level check in every workspace.Workspace roles
Within a workspace, every person holds one of four fixed roles, in rank order — there are no custom roles:
Rank is enforced on every role change and removal, by whoever makes it — the UI,
the API, a built-in admin tool, or a SCIM push:
- An admin cannot change the role of, or remove, someone who outranks them, and cannot grant a role above their own.
- Nobody changes their own role.
- A change that would leave the workspace with no admin or owner is refused.
- Instance admins cannot be renamed or removed from inside a workspace — not by an owner, not by a SCIM push. Offboarding someone who operates the instance means removing their instance role first.
Where roles are managed
Workspace admins manage people and roles in Settings → People, or through groups that grant a role. People can also arrive and depart automatically — see how people join a workspace below and SCIM provisioning. (The API calls the people in a workspace its members:ListWorkspaceMembers, the members:read scope.)
How people join a workspace
Joining follows from authentication: in a single-workspace deployment every signed-in user belongs to the workspace. In a multi-workspace deployment people join a workspace in three ways: by signing in through its SSO provider with an address at one of its domains, by accepting an invite, or through SCIM. An invite reaches only an address at a domain the workspace has verified or at the inviting admin’s own, and needs an instance admin to have set up email; people elsewhere, such as contractors at another company, join through SCIM. Someone new joins with the Member role, unless an invite gives another role or a group grants one.Roles from groups
A group can grant the people in it a workspace role — Admin, Member or Viewer — chosen next to the group’s name in Settings → Groups & Policies. While someone is in at least one role-granting group, the groups decide their role:- They hold the highest role any of their groups grants. Joining a group that grants Admin makes them an admin; leaving it drops them to the next-highest role their other groups grant, or back to Member when none does.
- Settings → People shows the role as coming from the group, and it can’t be changed there: remove them from the group (or add them to another) instead.
- Owners are never affected, and no group can grant the owner role. An owner in a role-granting group can be demoted only to the role their groups grant, which the groups then manage.
- Group memberships your directory keeps for someone it has deactivated don’t count (they count again when it reactivates them).
Display names
Anyone can change their own name from the account menu (Edit profile), except someone SCIM provisions: their directory owns their name, so they change it there. A person’s name is shared by every workspace they belong to, so a workspace admin can rename someone in Settings → People only when the workspace owns their account: the person signs in through one of the workspace’s own identity providers, isn’t provisioned by SCIM (the directory owns their name; change it there), and doesn’t outrank the admin. Instance admins are out of reach, as above. The person’s row menu says why a rename isn’t available, and every rename is recorded in the audit log. A name set by the person or an admin is never replaced by a later SSO sign-in.Invites
A workspace admin can invite people by email from Settings → People (Invite), with a role of admin, member or viewer, no higher than their own; pending invites are listed below the people in the workspace. The address must be at the admin’s own email domain (when their address is confirmed and the domain isn’t a public service such as gmail.com) or at a domain the workspace has verified. The invite’s link goes only into the email Conduit sends, so invites need an instance admin to have set up email; nobody else ever sees the link, and holding it proves the invitee controls the address. The link works for 7 days; resending an invite sends a new link and stops the old one working, and admins can cancel an invite. Each resend of the same invite waits longer after the last send (1 minute, then 5 and 30 minutes, 2 hours, and a day from then on), so one invite can’t flood an inbox. A workspace holds at most 200 invites, and sends are capped per admin and per workspace. The link opens the workspace’s login page. The invitee signs in with the address the invite was sent to, one of the ways the workspace accepts, and confirms joining, signed in a way the workspace accepts. The account must be theirs: its address has to be confirmed (by a password account, a provider the instance trusts, or a workspace’s own provider at a domain it verified), or the sign-in has to come through this workspace’s own provider; a different or unconfirmed address is refused. Someone with no such account, invited to a workspace that accepts email and password, creates their account there with a password instead, confirmed by the invite, and joins as they do. Joining by invite gives the invite’s role, but never more than the admin who last sent it could grant when it’s accepted: an invite from an admin since demoted gives at most their new role, and one from an admin since removed no longer works until another admin resends it. Someone already in the workspace is raised to the invite’s role when it is higher, unless a group decides their role. Removing someone, or changing their role, ends any invite they still hold to the workspace. Invites are for multi-workspace deployments: in a single-workspace one everyone who signs in joins. Every invite, resend, cancellation, redemption and failed send is in the audit log. An invited password account has no self-service password reset.Groups
Groups are the unit policies attach to. In Settings → Groups & Policies, select a group’s membership count to add or remove people and agents in one list. Human membership comes from two sources that coexist:- created by hand in Settings → Groups & Policies,
- pushed from your directory by SCIM — marked SCIM in the UI, and reconciled back to the directory on every sync.
Access policies
Which tools a person’s AI client sees — and may call — is the intersection of two things:Allow policies (admin-managed)
An allow policy (Settings → Groups & Policies) grants connector entries to subjects: Everyone (the whole workspace: all people in it, including people who join later), a group, or an individual person. A person’s allow set is the union of every policy that applies to them; a person no policy applies to has no access. Each entry names a connector and grants either:- All tools — including tools the upstream adds later, automatically.
- An explicit tool list — new upstream tools stay unavailable until an admin adds them. Pick this for connectors where new tools should be reviewed, the “all tools” form for connectors you trust wholesale.
The user’s own selection
Each person chooses which of their allowed connectors and tools are actually on, from the Connectors page. Until they make a selection, only Conduit’s built-in tools are active — an allowed connector or app waits for the person to switch it on. This keeps tool lists small by default (which agents handle better) and makes a new connector’s appearance in a client a deliberate act. An admin allowing a connector and a person enabling it are therefore both required before a tool reaches a client. “Allowed but not enabled” shows up in the person’s Connectors page as available to switch on. A connector counts as available to someone only when at least one of its tools is both allowed and turned on; until then its prompts and resources aren’t offered either.Agents
Agents are in beta and aren’t available in every workspace. An agent gets tools only from policies linked to groups it’s in, and only for apps and MCP servers. Policies for Everyone or for individual people never apply to it. Acting on behalf of someone, it’s also limited to what that person has and has turned on. Groups an agent is in, or whose people it may act on behalf of, are marked in Groups & Policies, and API clients can’t widen them. See Agent access.How enforcement works
- Policy is enforced on every tool listing and every tool call. A tool absent from the list cannot be invoked by name — listing and calling consult the same resolution.
- Changes take effect immediately: policy edits, group changes, membership changes, and a person’s own toggles all notify connected AI clients over the live MCP connection, and their tool lists refresh without a reconnect.
- Denied calls are recorded — in the audit log, in usage metrics
(
deniedoutcome), and in traces — so a policy that cut off something real is visible as a step change rather than silent breakage.
Inspecting a person’s access
Why does this person have this tool? — or not have it — is answered without reconstructing policy in your head: the People page’s effective-access view runs the real evaluator for anyone in the workspace and shows their groups, the allow policies that apply, and the resulting connector and tool grants. The same evaluation is exposed as a built-in admin tool (get_effective_access), so it can be asked from an AI client too.
Patterns worth knowing
- One connector per app. An app’s id,
app:<slug>, names it whatever backs it: Pipedream, or a custom server the workspace chose (Choose what backs an app). Grants of all its tools carry over a switch; grants naming specific tools apply only while the backend whose tools they name backs the app. A custom connector and the Pipedream app for the same service, left unlinked, are two connectors: allowing both to the same person means their client sees both tool sets. - OAuth scopes are a separate client ceiling. A grant can narrow a client to connectors, personal tools, workspace-admin tools, or instance-admin tools. It never widens access: server-side policy and the caller’s live role must still allow each listing and direct call.
- Built-in tools are role-gated and policy-governed. Conduit’s own tools come in three sets — for any user, for workspace admins, for instance admins — and a caller only ever sees the sets their role permits, subject to policy like everything else. Agents never get them.

