The Users API provides operations for user profiles, onboarding, workspace ownership transfer, login history, presence, multi-factor authentication, and enterprise authentication settings.
Member lifecycle operations such as role changes, member removal, and member blocking are documented under [REST API → API Reference → Teams & Members]
Endpoints
| Method | Path | Purpose |
| POST | /auth/save-user | Synchronize user profile |
| GET | /auth/user/:auth0Id | Get user profile |
| GET | /auth/user-channels/:identifier | Returns the channels associated with the identified user. |
| PUT | /auth/user/:auth0Id | Update user profile |
| POST | /auth/user/:auth0Id/profile-picture | Upload profile picture |
| PUT | /auth/user/:auth0Id/Workspace | Updates workspace business information associated with the authenticated user. |
| PATCH | /auth/onboard | Complete owner onboarding |
| PATCH | /auth/onboarding-step | Save onboarding progress |
| POST | /auth/workspace/transfer-ownership | Start ownership transfer |
| GET | /auth/workspace/transfer-ownership/details | Get transfer details |
| POST | /auth/workspace/transfer-ownership/accept | Accept transfer |
| POST | /auth/workspace/transfer-ownership/decline | Decline transfer |
| GET | /auth/user/:userId/login-history | Get member login historyFeature Gate: audit_logMinimum plan: GROWTH |
| GET | /auth/login-history | Get Workspace audit historyFeature Gate: audit_logMinimum plan: GROWTH |
| GET | /auth/login-history/users | List users with audit recordsFeature Gate: audit_logMinimum plan: GROWTH |
| GET | /auth/login-history/export | Export audit historyFeature Gate: audit_logMinimum plan: GROWTH |
| POST | /auth/logout | Terminate user session |
| GET | /user-status | Get Team Member presence |
| POST | /auth/mfa/enable | Enable MFA |
| POST | /auth/mfa/disable | Disable MFA |
| POST | /auth/mfa/dismiss | Dismiss MFA setup notice |
| GET | /auth/mfa/status | Get MFA status |
| POST | /auth/sso/config | Configure SAML SSOFeature Gate: ssoMinimum plan: ENTERPRISE |
The audit identifies these endpoints across user, history, MFA, role, and SSO controllers.
Need Help?
Email: support@ysdesk.com
Documentation: ttps://docs.ysplugins.com/ys-desk