Settings
Configure SparesHaven for you and your workspace.
Settings brings personal preferences and workspace configuration together in one place. Choose how SparesHaven looks, control notification preferences, manage the workspace currency, and configure secure API access for external systems.
Preferences and configuration
Understand Settings.
Settings contains both personal preferences and shared workspace configuration. The options available depend on your role in the organisation.
Personal
Your SparesHaven experience
Theme is stored as a user preference so you can choose how SparesHaven appears for your account.
Workspace
Shared organisation configuration
Owners and Admins can manage workspace-level options such as currency and API access.
Your role controls what you can change.
Standard Members can manage their available personal preferences and view the current workspace currency. Owners and Admins have additional workspace-management controls.
Appearance
Choose your SparesHaven theme.
Theme controls the appearance used by your SparesHaven account. Three options are available: System, Light, and Dark.
System
Use SparesHaven with the system-based appearance option.
Light
Use SparesHaven's light application theme.
Dark
Use SparesHaven's dark application theme.
Theme is a personal preference.
Changing your theme does not change the appearance selected by other people in the workspace.
Notifications
Manage notification preferences.
Owners and Admins can choose which categories of workspace notifications they receive. The preferences are stored against the individual profile.
Stock notifications
Control your preference for stock-related workspace notifications.
Order notifications
Control your preference for order-related workspace notifications.
Member activity notifications
Control your preference for workspace membership activity.
After changing your preferences, use Save settings to store the updated selections.
Workspace
Understand shared workspace settings.
Some settings affect the organisation rather than a single person. These controls are restricted to active Owners and Admins because changing them affects the shared workspace.
Workspace currency is visible to Members but can only be changed by an Owner or Admin. API access is only presented to Owners and Admins.
Currency
Controls the currency used to display monetary values throughout the workspace.
API access
Allows authorised workspace administrators to create and manage credentials for external integrations.
Currency
Choose the workspace currency.
Owners and Admins can choose the currency used to display monetary values throughout the workspace.
Euro (EUR)
British Pound (GBP)
US Dollar (USD)
Canadian Dollar (CAD)
Australian Dollar (AUD)
New Zealand Dollar (NZD)
Swiss Franc (CHF)
Japanese Yen (JPY)
Select the required currency and choose Save currency to update the workspace.
Important
Understand what changing currency does.
Changing the workspace currency changes how monetary values are displayed. It does not perform a financial conversion on values that already exist in SparesHaven.
Example
A currency change is not an exchange-rate conversion.
SparesHaven changes the displayed currency context. Existing monetary numbers are not recalculated using an exchange rate.
Choose the workspace currency deliberately.
If existing monetary values were entered for one currency, changing the workspace to another currency does not convert those stored values for you.
Integrations
Understand API access.
API access lets external applications and services authenticate securely with your SparesHaven workspace. Owners and Admins can create API keys and decide which supported datasets each key is allowed to read.
Inventory
Read-only access to inventory data.
Vendors
Read-only access to vendor data.
Orders
Read-only access to order data.
History
Read-only access to stock movement history.
API permissions are read-only in the current V1.
API keys can be limited to one or more of the supported read-only permissions. At least one permission must be selected when creating a key.
API keys
Create and save an API key securely.
Choose Create API key, give the key a descriptive name, and select the read-only permissions required by the integration. A name helps you identify the application or service using the credential later.
Once created, SparesHaven displays the complete API key so you can copy it into the integration that needs it.
1. Name
Identify the integration
Give the key a descriptive name that makes its purpose recognisable later.
2. Permissions
Choose what it can read
Select one or more supported read-only permissions for the integration.
3. Copy
Save the secret immediately
Copy the generated API key and store it securely before closing the creation window.
The complete API key is shown only once.
After the creation window is closed, SparesHaven does not show the complete secret again. If the key is lost, revoke it and create a replacement.
API security
Review, revoke, and remove API keys.
The API access area separates active and revoked credentials. For each active key, SparesHaven shows identifying information including its name, masked prefix, permissions, creation date, and when it was last used.
Active
Available for authentication
An active API key can be used by its integration with the permissions assigned to that key.
Revoked
Access permanently disabled
Revoking a key immediately prevents integrations using that key from authenticating with the SparesHaven API.
Deleted
Permanently removed
A revoked API key can be permanently deleted when you no longer need to retain its record in SparesHaven.
Revoke first, delete second.
Active API keys are revoked when access needs to stop. Revocation cannot be undone; if access is required again, create a new key. Permanent deletion is available from the revoked-key area.
Permissions
Understand what each workspace role can manage.
Settings adapts to the signed-in person's workspace role. Personal and administrative controls are kept separate so shared workspace configuration remains protected.
Owner
Can manage their theme and notification preferences, change workspace currency, and manage API access.
Admin
Can manage their theme and notification preferences, change workspace currency, and manage API access.
Member
Can manage the available personal appearance preference and view the workspace currency, but cannot change privileged workspace settings.
Workspace controls are deliberately restricted.
Currency and API access can affect the wider organisation or external integrations. SparesHaven therefore reserves their management for Owners and Admins.
Continue learning