> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gominerva.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Workspaces Guide

> How Live and Calibration workspaces isolate Minerva configuration, presets, and promotion workflows.

export const StorybookFrame = ({storyId, title, version = "20260419-1", height, zoom = 0.7, preferLocalPreview = false}) => {
  const HOSTED_STORYBOOK_BASE_URL = "https://minerva-storybook.s3.ca-central-1.amazonaws.com/iframe.html";
  const isLocalDocsPreview = typeof window !== "undefined" && ["localhost", "127.0.0.1"].includes(window.location.hostname);
  const storybookBaseUrl = preferLocalPreview && isLocalDocsPreview ? "http://localhost:6006/iframe.html" : HOSTED_STORYBOOK_BASE_URL;
  const params = new URLSearchParams({
    id: storyId,
    viewMode: "story",
    singleStory: "true",
    shortcuts: "false",
    toolbar: "0",
    nav: "0",
    panel: "0"
  });
  params.set("v", version);
  const src = `${storybookBaseUrl}?${params.toString()}`;
  const unscaledHeight = `${Math.ceil(height / zoom)}px`;
  const unscaledWidth = `${100 / zoom}%`;
  return <div style={{
    width: "100%"
  }}>
      <div style={{
    height: `${height}px`,
    overflow: "hidden",
    border: "1px solid #e2e8f0",
    borderRadius: "12px",
    backgroundColor: "#ffffff",
    display: "flex",
    justifyContent: "center",
    alignItems: "flex-start"
  }}>
        <iframe src={src} title={title} loading="lazy" style={{
    width: unscaledWidth,
    height: unscaledHeight,
    transform: `scale(${zoom})`,
    border: "0",
    display: "block",
    transformOrigin: "top center",
    flexShrink: 0
  }} allowFullScreen></iframe>
      </div>
    </div>;
};

Workspaces let one organization run more than one Minerva operating context. Each workspace has its own screening configuration, saved presets, and audit history, so administrators can tune settings away from production before deciding what to promote into Live.

**Access:** Requires the <strong>Admin</strong> role or above. Use the workspace selector in the sidebar to switch your current workspace. To manage workspaces, go to <strong>Administration</strong> > <strong>Configuration</strong>, then open <strong>Workspaces</strong>.

Use this guide when you need to:

* understand what changes when you switch workspaces
* tune configuration in a Calibration workspace without changing Live
* save reusable workspace presets
* promote a preset from Calibration to Live
* decide which settings are workspace-scoped and which settings are tenant-wide

<Info>
  <strong>Live</strong> is the default production workspace.{" "}
  <strong>Calibration</strong>
  is the recommended workspace for testing configuration changes before they are
  used in Live screening and risk-assessment workflows.
</Info>

<Warning>
  Calibration is isolated from Live, but it still uses real Minerva workflows.
  Use representative approved test cases, avoid unrelated customer data, and
  confirm the selected workspace before creating or changing records.
</Warning>

## Switching Workspaces

The workspace selector appears in the main sidebar. The selected workspace controls the workspace-aware configuration that the app uses for the current organization. The example below shows the actual Workspaces configuration page with the selector open.

<StorybookFrame storyId="components-navigation-workspace-switcher--default" title="Workspace Selector" height={560} version="20260525-2" />

Most organizations start with two active workspaces:

| Workspace                    | Purpose                                                                                                                                            |
| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| <strong>Live</strong>        | The default production workspace for active operations, production API usage, onboarding, ongoing monitoring, and analyst review.                  |
| <strong>Calibration</strong> | A separate workspace for testing match scoring, repeated alert suppression, and other operational settings before those settings are used in Live. |
| Additional active workspaces | Optional team, region, product, or integration-specific workspaces when your organization needs more than one non-production context.              |
| Archived workspaces          | Workspaces that are no longer selectable for active use. API keys tied to an archived workspace should be treated as disabled.                     |

When you switch workspaces, the sidebar label changes immediately. Configuration pages, presets, and workspace-scoped API behavior should then reflect the selected workspace.

<Tip>
  If a result or configuration does not look familiar, check the workspace
  selector before editing. Many troubleshooting cases come from reviewing
  Calibration while expecting Live, or the reverse.
</Tip>

## What Is Workspace-Scoped

Workspace-scoped configuration changes with the selected workspace. It is owned by the workspace so that Calibration can safely diverge from Live while administrators test changes.

Workspace-scoped settings include:

* [Match scoring](/match-scoring-guide), including feed thresholds, workflow thresholds, and News retrieval controls
* [Role-aware adverse media](/role-aware-adverse-media-guide), including article labels, confidence thresholds, and automatic adverse-media filtering
* [Repeated Alert Suppression](/alert-suppression-guide), including repeat-alert rules and suppression state
* screening source and feed settings where available
* automatic disposition and alert tuning settings where available
* risk-assessment and continuous risk review settings where available
* webhook and integration settings that are explicitly workspace-specific
* profile groups and screening frequency settings for the selected workspace
* custom workspace presets and configuration history for each supported configuration page

Tenant-wide settings do not change only because you switch workspaces. These usually include identity, authentication, and account bootstrap behavior such as [SAML SSO and SCIM](/authentication-sso-scim-guide).

<Info>
  Workspace-aware API and service calls use the current workspace context behind
  the scenes. In the app, the selected workspace is sent with requests. For
  integrations, API keys and server-side authorization determine which workspace
  configuration applies.
</Info>

## Configurations And Presets

Configuration pages usually combine three related concepts:

| Concept                               | What it means                                                                                                                                                        |
| ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <strong>Active configuration</strong> | The configuration currently used by the selected workspace. Saving a reviewed change updates this configuration and writes a history entry.                          |
| <strong>Built-in preset</strong>      | A fixed Minerva preset, such as Balanced, Narrow, Wide, Conservative, or Aggressive. Built-in presets are available across workspaces and cannot be edited directly. |
| <strong>Workspace preset</strong>     | A custom saved preset that belongs to one workspace. It can be reused in that workspace or promoted into another workspace, such as from Calibration into Live.      |

Use workspace presets when a configuration has an operational purpose that you may want to reuse later. A good preset name and description should explain why it exists, what workflow it supports, and whether it is intended for Live use or continued calibration.

<StorybookFrame storyId="pages-tenant-config-match-scoring--default" title="Match Scoring Configuration Page" height={1320} version="20260610-1" />

## Promote A Workspace Preset

Promotion copies a saved workspace preset from the current workspace into another workspace. The common path is to tune and save a preset in Calibration, then promote that preset into Live.

Promotion does two things:

1. Copies the saved preset into the target workspace.
2. Optionally applies that preset to the target workspace immediately.

The immediate apply option is deliberate. Leaving it off stages the preset in the target workspace so an administrator can review it later. Turning it on updates the target workspace's active configuration as soon as the promotion is confirmed.

<StorybookFrame storyId="pages-tenant-config-match-scoring--promote-workspace-preset" title="Match Scoring Preset Promotion" height={900} version="20260525-2" />

The same promotion model is used by other workspace-aware configuration pages that support custom presets.

<StorybookFrame storyId="pages-tenant-config-alert-suppression--promote-workspace-preset" title="Repeated Alert Suppression Preset Promotion" height={900} version="20260525-2" />

Use the immediate apply option only when you are ready for the target workspace to use the promoted configuration for new activity. For Live, that can affect new screening, monitoring, API, and risk-assessment behavior depending on the configuration being promoted.

## Calibration To Live Workflow

Use this sequence when testing configuration changes before production rollout:

1. Select <strong>Calibration</strong> from the sidebar workspace selector.
2. Open the configuration page you want to tune, such as [Match Scoring](/match-scoring-guide) or [Repeated Alert Suppression](/alert-suppression-guide).
3. Start from the closest built-in preset or the current Calibration preset.
4. Make one focused set of changes and add a clear change description when saving.
5. Test with representative approved cases in Calibration. For screening, compare result volume, false positives, missed-risk sensitivity, and analyst workload. For risk assessments, compare the retrieved evidence and final reasoning against expected behavior.
6. Save the calibrated settings as a workspace preset with a name and description that explain the intended Live use.
7. Promote the preset to <strong>Live</strong>. Leave immediate apply off if you want to stage the preset for a final Live review, or turn it on only when you are ready to deploy the configuration.
8. Switch to <strong>Live</strong>, confirm the configuration and active preset, then monitor the first affected workflows.

<Tip>
  Keep Calibration and Live changes small enough to explain in one history
  entry. Small, named changes are easier to audit and easier to roll back than
  broad tuning passes across several independent settings.
</Tip>

## Related Guides

* [Match Scoring Guide](/match-scoring-guide)
* [Role-Aware Adverse Media Guide](/role-aware-adverse-media-guide)
* [Repeated Alert Suppression Guide](/alert-suppression-guide)
* [Profile Groups Guide](/profile-groups-guide)
* [Screening Frequencies Guide](/screening-frequencies-guide)
* [Screening Guide](/screening-guide)
* [Risk Assessment Flow](/risk-assessment-flow)
* [API Keys](/api-reference/api-keys)
* [SAML SSO And SCIM Guide](/authentication-sso-scim-guide)