Manage your account
Every signed-in user has an account page. It shows your name and email address, lets you change your password, and lists the invitations waiting for you and the tenants you belong to.
You need no special permission for this page. Everything on it acts on your own account only.
Open your account page
Click My tenants at the bottom of the sidebar. The page opens on the General tab and is titled with your own name.
Accept an invitation
A tenant Owner can invite you to their tenant. When you have pending invitations, My tenants in the sidebar shows how many.
- Click My tenants in the sidebar.
- Under Pending invitations, each invitation names the tenant and the role you are invited as.
- Click Accept to join the tenant, or Decline.
Change your password
- Click My tenants in the sidebar.
- Under Password, click Change password.
- Type your Current password. Then type the password you want under New password, and the same one again under Confirm new password.
- Click Change password.
The portal says Password changed. You'll need to sign in again on every device. Changing your password signs you out everywhere, including the browser you used, so anyone who knew your old password loses access too.
If the sign-out fails, the portal says Password changed, but we couldn't sign you out of your other devices. Sign out on each of them yourself. Your new password is saved, but sessions opened with the old one stay signed in until you sign them out.
The password you choose here is permanent. Unlike a password an administrator sets for you, you are not asked to change it again at your next sign-in.
If the two new passwords are not the same, the form says The new passwords do not match. If your current password is wrong, it says Current password is incorrect. If the new password breaks the password rules of your identity provider, it says User details or password do not meet the identity provider policy.
When your password is managed elsewhere
Some accounts sign in through your organization's own sign-in service or user directory. Those accounts have no Change password button. The Password section says instead:
Your organization's sign-in service manages your password. Change it there.
Change your password where your organization tells you to. A platform administrator cannot set a password for these accounts either.
If you forget your password
You need your current password to change it yourself. If you have forgotten it, ask a platform administrator to give you a new one.
Operations
All operations are POST requests with a JSON body. They always act on the account you are signed in as, so neither of
them takes a user ID. These are not tenant operations, so make the calls without selecting a tenant.
An API key cannot use these operations, not even a personal one. Call them as a signed-in user.
| Operation | What it does |
|---|---|
GetPasswordStatus | Says whether you can change your password here |
ChangePassword | Replaces your password and ends all your sessions |
Check whether you can change your password
POST /cmind.users.v1.AccountService/GetPasswordStatus
The request has no fields.
Response Fields:
changeable:truewhen your password is stored in the platform and you can change it here.falsewhen your organization's sign-in service or user directory owns it.
Change your password with the API
POST /cmind.users.v1.AccountService/ChangePassword
Request Fields:
currentPassword(required): Your current password, between 1 and 1024 characters.newPassword(required): The new password, between 1 and 1024 characters. It must meet the password rules of your identity provider.
After the change, all your sessions end, including the one that made the call. Sign in again with the new password to get a new token.
Response Fields:
sessionsEnded:truewhen all your sessions ended.falsewhen the password changed but your sessions could not be signed out; sessions opened with the old password then stay signed in.
A wrong current password fails with invalid_argument. A new password that breaks the rules of your identity provider
fails with invalid_argument as well. An account whose password is managed outside the platform fails with
failed_precondition.