AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
TypeScript ai-agentai-agent-toolsai-agentsai-agents-frameworkmcpmcp-servermcp-toolsmcpsn8n-alternativeno-code-automationworkflowworkflow-automationworkflows
icon: 👥
Users
Manages user identity, platform membership, roles, and session security. A User ties a UserIdentity (canonical email/password/OAuth identity) to a specific platform, so the same person can exist across multiple platforms.
Entities
- User: id, platformRole (ADMIN/MEMBER/OPERATOR), status (ACTIVE/INACTIVE), identityId (FK), externalId, platformId, lastActiveDate. Unique on
(platformId, identityId). - UserIdentity: email, hashed password, firstName, lastName, provider (EMAIL/GOOGLE/SAML/JWT), verified, tokenVersion. One identity → many users across platforms.
Platform roles
- ADMIN: full platform control, all projects visible.
- MEMBER: own projects + team projects where a member.
- OPERATOR: all projects except others' personal projects.
Session management
- JWTs: 7-day for users, 100-year for engine/worker.
tokenVersionon UserIdentity: incrementing invalidates all issued tokens. Logout increments it → all sessions invalidated.- Validation checks: status ACTIVE + identity verified + tokenVersion match.
Endpoints
GET /v1/users/me,POST /v1/users/me(update firstName/lastName/profilePicture) — CE.- Platform admin CRUD (list, update role/status, delete) via
platform-user-controller.ts— EE/Cloud.
Gotchas
- Deleting a user also deletes its
UserIdentityon self-hosted (CE/EE), but only when noUserrow on any platform still references that identity. Skip that cleanup and the orphaned identity keeps the email claimed: re-inviting the same person dead-ends withEXISTING_USER/INVITATION_ONLY_SIGN_UPon sign-up andINVALID_CREDENTIALSon sign-in, and CE has no reset-password path to recover from it.otprows cascade away with the identity. - Cloud takes the other branch.
platform-user-controller.tsroutes Cloud toremoveFromPlatform, which nullsplatformIdand keeps the identity, since the same person may belong to other platforms. Only the CE/EEdeletepath removes identities. userIdentityService.creatematches email globally, ignoring platform, so any identity left behind with noUserrow blocks sign-up for that email on every platform. Installs that deleted users before this cleanup existed still carry those orphans; clearing them needsDELETE FROM user_identity ui WHERE NOT EXISTS (SELECT 1 FROM "user" u WHERE u."identityId" = ui.id).getOrCreateWithProjectcreates the user, their personal project and their default-project memberships in one transaction, because an existing user is never "new" again: a failure after the user row is saved would leave them without their default projects forever. Personal-project post-create hooks run after commit. The default-project join isuserHooks.postCreate, a no-op in CE anduserEnterpriseHooksin EE/Cloud.- Managed-auth (embedding) users never join default projects.
managed-authn-service.tscreates them withuserService.create, notgetOrCreateWithProject, souserHooks.postCreatenever runs. That's on purpose: an embedded user is the platform's own customer, scoped to the project in their token, and joining the platform's default projects would open internal or shared projects to them. - People invited as Admin or Operator don't join the default projects. Only users created as Members join them. Most users are created as Members and promoted afterwards by
provisionUserInvitation, so the EEuserHooks.postCreatealso skips the join when an accepted Admin or Operator platform invite exists (getAcceptedAdminOrOperatorInviteRole), unless the caller assigned the role. SCIM create assigns it: theplatformRolethe identity provider sends, else the accepted Admin or Operator invite's role, else Member. An explicit SCIM role always wins over an invite. - A SCIM-managed project used as a default loses members SCIM didn't add. A full SCIM group sync replaces that project's members with the identity provider's list, which removes the Editors who joined it as a default.
Key files
Entry point: userService, a log-scoped factory in user/user-service.ts that most callers across the API import directly.
packages/server/api/src/app/user/— user service and the User/UserIdentity entitiespackages/server/api/src/app/user/platform/— EE platform admin user endpoints, registered asplatformUserModuleinapp.tspackages/server/api/src/app/ee/users/— the/v1/users/mecontroller and modulepackages/core/shared/src/lib/core/user/— User and UserWithMetaInformation schemas, PlatformRole and UserStatus enumspackages/web/src/app/routes/platform/users/— platform admin user list page and table columnspackages/web/src/app/routes/platform/users/actions/— row action menu, edit role/status dialog, toggle status, deletepackages/web/src/features/authentication/— sign-in, sign-up, change-password forms and the auth React Query hooks
Paths verified 2026-07-17.