Skip to main content
Version: 3.6.1-rc.2

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.

  1. Click My tenants in the sidebar.
  2. Under Pending invitations, each invitation names the tenant and the role you are invited as.
  3. Click Accept to join the tenant, or Decline.

Change your password​

  1. Click My tenants in the sidebar.
  2. Under Password, click Change password.
  3. Type your Current password. Then type the password you want under New password, and the same one again under Confirm new password.
  4. 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.

OperationWhat it does
GetPasswordStatusSays whether you can change your password here
ChangePasswordReplaces 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: true when your password is stored in the platform and you can change it here. false when 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: true when all your sessions ended. false when 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.