P4 Software / activoHQ English

My profile

My profile

Overview

The My Profile screen lets each user manage their own identity within ActivoHQ: update first name, last name and email address; change their password; choose the interface language; decide which system emails they receive; and, for administrators, generate and manage the personal API key used to call the ActivoHQ REST API. Each user only reaches their own information; you cannot edit another user's profile from this screen.

How to get there

Click your name or avatar in the top right corner of any screen and choose My Profile from the drop-down menu.

Direct URL: /profile

Key concepts

Term Definition
Identity The user's personal details: first name, last name and email address.
Username The sign-in identifier assigned by the administrator. The user cannot edit it.
User type The role assigned to the user on the account (for example, Administrator, standard user). It is display-only; it is not changed from this screen.
Language The ActivoHQ interface language for this user (English or Spanish).
API key The personal credential administrators use to authenticate against the ActivoHQ REST API through the X-Api-Key header.

How to use it

Update your identity details

  1. Open My Profile.
  2. In the Identity section, change one or more of the editable fields: First name, Last name or Email.
  3. To change the interface language, pick the option you want from the Language drop-down (available unless your account is a superuser account).
  4. Click Save at the top of the screen.
  5. The system shows the Profile saved notification when it finishes.

Change your password

  1. In the Change password section, type your current password in Current password.
  2. Type the new password (at least 8 characters) in New password.
  3. Repeat the new password in Confirm new password.
  4. Click Update password.
  5. If the change succeeds, the system shows the Password updated notification. Your session stays active; you do not need to sign in again.

Choose which emails you receive

The Email notifications section controls the system emails sent to your address. Both are off by default: Off by default. Turn on the system emails you want to receive.

  1. Tick Low-stock alerts to be notified when an asset model falls below its alert threshold.
  2. Tick Coverage renewals to be notified about upcoming warranty, Insurance and license renewals.
  3. Click Save preferences. The system shows the Preferences saved notification.

These preferences are per user. Turning an alert on only affects your own mailbox, and the emails only go out if your administrator has configured the mail server - see Email settings.

Generate an API key (administrators only)

  1. In the Developer API section, click Generate API key.
  2. The system creates a new key and shows it in clear text automatically so you can copy it straight away.
  3. Click the copy button (clipboard icon) to copy the key. The Copied to clipboard notification appears.
  4. Store the key somewhere safe. It is only shown in full at the moment it is generated or when you use the reveal function.

Reveal or hide the API key

  1. In the Developer API section, find the Your API key field.
  2. By default the key is masked (the first 8 characters, then dots, then the last 4 characters).
  3. Click the eye button (Reveal) to see the full key.
  4. Click it again (Hide) to mask the key.

Copy the API key to the clipboard

  1. With the key already generated, click the copy button (clipboard icon) beside the Your API key field.
  2. If it works, the Copied to clipboard notification appears.
  3. If the browser blocks the operation, the message Couldn't copy. Select and copy manually. appears.

Regenerate the API key (administrators only)

  1. In the Developer API section, click Regenerate.
  2. The system invalidates the previous key and generates a new one, visible immediately.
  3. Update every integration or application that was using the old key.

Revoke the API key (administrators only)

  1. In the Developer API section, click Revoke.
  2. The system deletes the active key. The field is emptied and the API key revoked notification appears.
  3. From that moment on, no API request using the old key will authenticate.

Fields

Section: Identity

Field Type Required Description Validation
Username Text (read-only) - Sign-in identifier. Not editable. -
User type Tag (read-only) - The user's role on the account. -
First name Text field Yes The user's first name(s). -
Last name Text field Yes The user's last name(s). -
Email Text field (email) Yes The user's email address. Must be a valid email address.
Language Drop-down No Interface language: English or Spanish. Not shown for superuser accounts. -

Section: Change password

Field Type Required Description Validation
Current password Password field Yes The user's current password. Required to confirm the change. Must match the password recorded in the system.
New password Password field Yes The new password. At least 8 characters.
Confirm new password Password field Yes The new password repeated, to catch typing mistakes. Must be identical to New password.

Section: Email notifications

Field Type Required Description Default
Low-stock alerts Checkbox No Notify me when an asset model falls below its alert threshold. Off
Coverage renewals Checkbox No Notify me about upcoming warranty, Insurance, and license renewals. Off

Section: Developer API (administrators only)

Field Type Required Description Validation
Your API key Monospace text (read-only) - Personal key used to authenticate against the REST API through the X-Api-Key header. Masked by default. -

Permissions

Every authenticated user can view and edit their Identity details, change their password and set their email notifications.

The Developer API section is only for users with the Administrator role. Users with other roles do not see this section.

Notes

  • API key security: the key grants access to all of your organization's data in ActivoHQ. Treat it like a password: do not share it, do not put it in public source code, and change it immediately if you suspect it has been exposed. The full API reference is available through View API reference.
  • Regenerating invalidates the old key: when you regenerate the API key, the previous key stops working immediately. Update every integration before or right after regenerating.
  • Language applies only to the current user: changing the language in My Profile does not affect other users on the account.
  • Changing your password does not sign you out: after a successful password update, the active session continues without interruption.
  • Notification preferences are personal: they do not change what other users receive, and they do not switch the alerts on for the whole company.

Troubleshooting

Symptom Likely cause Resolution
The message "Your profile couldn't be loaded. Please sign in again." appears The session expired or the authentication context was lost. Sign out and sign in again.
Clicking Update password shows "The new passwords don't match." Confirm new password is not identical to New password. Type both passwords again, making sure they match.
Clicking Update password shows "The current password is incorrect." The current password was typed wrongly. Enter the password you currently sign in with. If you have forgotten it, ask your administrator for a reset.
The copy button shows "Couldn't copy. Select and copy manually." The browser blocked clipboard access (permissions policy). Click Reveal to show the full key, then select it with the mouse and copy it with Ctrl+C.
The Developer API section is not shown. The user does not have the Administrator role. Ask your account administrator to change your user type if you need API access.
The Language field is not shown. The user is a superuser. Language selection does not apply to that profile. Contact support if you need the interface language changed.
The alerts are ticked but no email arrives. The mail server is not configured, or there is nothing below threshold or coming due. Check Settings > Email and confirm the mail server is configured. See Email settings.

Related

Was this page helpful?

Previous Signing in Next Creating an account (sign-up)