Administration

Users & roles

Invite people into your organization, give each one of four roles, see what they run and spend, and remove them cleanly when they leave.

The Users page lists everyone with access to your organization. From here you invite teammates, change their role, watch their usage and cost, and remove people who no longer need access. It lives under Organization in the left sidebar and is available to owners and admins.

Every person has exactly one role in an organization: Owner, Admin, Builder or Member. The role decides what they can create, edit, run, share and manage. Roles are enforced by the platform on every request, not just hidden in the interface, so a person cannot do more than their role allows from the API or from a connected assistant either.

How access works

Inviteemail + role
Acceptmagic-link email
Roleowner · admin · builder · member
Shares & groupsextra access
Every action checkedrole x resource
You invite a person with a role. When they accept, the role sets their baseline. Sharing a resource with them, directly or through a group, adds access on top. Every action they take is checked against both.

The four roles

RoleTypeWhat it does
Ownerone per orgFull control. The only role that can change the plan, buy credit, transfer ownership or delete the organization. Created when the organization is created.
AdminmanagerFull organization access except billing and ownership. Manages members, groups, workspaces, organization settings, tool and model connections, sharing, public links and API keys. Can see billing but not change it.
BuildermakerCreates and edits their own agents, teams, AI employees, knowledge bases and tables. Uses tools and models the organization has connected, and can connect personal tools and model keys for their own work. Cannot manage members or change organization settings.
MemberuserRuns the agents, teams and AI employees shared with them, and reads knowledge bases their visibility allows. Cannot create, edit or delete anything, and cannot manage members or the organization.

Step by step

  1. Open the Users page

    Click Users in the sidebar. The strip at the top shows Total users(with active, pending and disabled counts), Active · 7d, Total executionsand Cost · MTD (month to date, with the average per user). Below it, filter byAll, Active, Pending or Disabled, search by name, email or role, or narrow the list with the Role filter.

    app.turtleaicoworker.com/users
    Users page header with total users, active in 7 days, total executions and cost month to date, plus status tabs, search and role filter
    The Users page: usage at a glance, then a filterable list of everyone in the organization.click to enlarge

    Each row in the list shows the person's Role, Status,Executions, Cost, Success rate and Last activetime. The Actions column holds three buttons: view details, edit role, and remove.

  2. Invite a user

    Click Invite user. Enter their Email address and pick aRole. The box under the role lists what that role can and cannot do, so you can check before sending. Click Send invitation. The person gets a magic-link email and joins with the role you chose. The invitation expires in 7 days.

    Invite a new user dialog with Email address, Role and the Builder permissions list
    Invite a new user: pick the role, read its permissions, then send the invitation.click to enlarge
  3. Manage pending invitations

    An invited person appears with a Pending status until they accept. Use the resend button to send the email again, or the remove button to Cancel Invitation.

  4. Change someone's role

    Click the pencil in the Actions column to open Change role. The current role is marked Current. Choose Admin, Builder orMember and click Save changes. The change applies straight away. The owner's role cannot be changed here; use Transfer ownership inOrganization settings instead.

    Change role dialog with Admin, Builder (current) and Member options
    Change role: Admin, Builder or Member, each with a one-line summary.click to enlarge
  5. Review one person's activity

    Click the eye icon to open a person's detail page. Pick the period at the top, such asLast 30 days. The header shows their role, job title, when they joined, when they were last active and the groups they belong to. Below it you see Cost attributable,Runs triggered, Success rate, Tokens andActive days, then an activity timeline, their sessions and whether they have activated (made their first run).

    app.turtleaicoworker.com/users
    User detail cards for cost attributable, runs triggered, success rate, tokens and active days, with an activity timeline
    A person's usage for the chosen period, and how active they have been.click to enlarge

    Further down, What they touch splits their activity across agents, agentic teams and AI employees. Creation footprint counts what they built and flags Dormant assets owned: things they own that have not run in 30 days. Cost & consumption shows daily spend and cost by model, Reliability of their work ranks their most error-prone assets, and Security posture lists their active sessions and whether two-factor authentication is on.

    app.turtleaicoworker.com/users
    What they touch donut, creation footprint with built assets, most-used creation and dormant assets, and cost trend by model
    Creation footprint and cost: what a person built, what they use most, and what it costs.click to enlarge
  6. Remove a user

    Click the red bin icon and confirm Remove. The person loses access to the organization at once. Everything they owned, including agents, teams, AI employees, knowledge bases and tables, is transferred to the organization owner, so nothing stops working when someone leaves. Admins can remove Builders and Members; removing an Admin needs the owner.

What each role can do

The table below comes from the platform's authorization rules. "Own" means resources the person created. "Shared" means resources shared with them directly, through a group, or visible to the whole organization.

ActionTypeWhat it does
Change plan, buy creditOwnerOnly the owner. Admins can view billing and usage.
Transfer ownership, delete orgOwnerOnly the owner.
Edit organization settingsOwner, AdminName, logo, AI disclosure, pause, parallel runs. Everyone can view them.
Invite, remove, change rolesOwner, AdminAdmins can only invite, remove or assign Builders and Members.
Create and manage groupsOwner, AdminBuilders can add their own resources to an existing group.
Create and delete workspacesOwner, AdminEveryone can see and open the workspaces they belong to.
Connect organization tools and modelsOwner, AdminThe Models page is hidden from Builders and Members.
Connect personal tools and model keysOwner, Admin, BuilderFor a Builder's own agents. Members cannot.
Create agents, teams, employees, KBs, tablesOwner, Admin, BuilderMembers cannot create.
Edit or delete a worker, KB or tableOwnBuilders edit what they created. Owners and admins can edit anything.
Run agents, teams, AI employeesSharedBuilders and Members run what they own or what is shared with them. Owners and admins run anything.
Approve or reject an AI employee taskSharedAnyone who can see the employee.
Add, edit, delete table rowsUse shareBuilders and Members need a Can use share on someone else's table.
Share, publish public links, create API keysOwner, AdminBuilders and Members cannot share workers or publish them outside the organization.
Build and share interfaces (dashboards)Owner, AdminBuilders and Members open the interfaces shared with them.
Install solution packs and templatesOwner, Admin, BuilderMembers can browse the gallery but not install.
Update own profile and securityEveryoneName, photo, password, two-factor authentication, sessions and notifications.

Field reference

FieldTypeWhat it does
Email addressemailRequired on invite. Where the magic-link invitation is sent.
RoleselectRequired on invite. Admin, Builder (the default) or Member.
Statusread onlyAccepted once they join, Pending while the invitation is open, or Disabled.
ExecutionscountRuns this person started.
CostcurrencyModel and run cost attributable to this person.
Success ratepercentShare of their runs that completed cleanly.
Last activetimeWhen they last did something in the organization.

Related