Skip to main content

Sub-Organizations

Sub-organizations allow parent organizations to create isolated groups within their account — useful for managing multiple teams, clients, or business units under a single subscription.

Availability

Sub-organizations are available on Tier 3 and Alpha plans only.

Overview​

  • Sub-organizations share the parent organization's scan quota and LOC limits
  • Each sub-org can have its own members, repository submissions, BYOK key, and branding logo
  • Parent org admins have full visibility and control over all sub-orgs
  • Members of the parent organization can see repositories submitted for all sub-organizations
  • Sub-org-only members can only see repositories and data belonging to their sub-org

Creating a Sub-Organization​

Only parent org admins can create sub-organizations.

  1. Go to Settings in the top navigation bar
  2. Scroll to the Sub-Organizations section
  3. Click Create Sub-Organization
  4. Enter a unique name for the sub-org
  5. Click Create

The new sub-org will appear in the list immediately.

Managing Members​

Viewing Members​

Click on a sub-org row in the Settings page to expand its management panel, then select the Members tab.

Adding Members​

Parent org admins and sub-org admins can add members:

  1. Open the sub-org management panel in Settings → Sub-Organizations
  2. Click Add Member
  3. Select an existing organization user or enter an email to invite a new member
  4. Click Add
note

Members must belong to the same parent organization. Cross-tenant additions are not allowed.

Removing Members​

  1. Open the sub-org management panel
  2. Click Remove next to the member you want to remove

Sub-org admins can remove regular members. Only parent org admins can remove sub-org admins.

Submitting Repositories for a Sub-Organization​

When submitting a repository, you can assign it to a specific sub-org:

  1. Go to Submit Repository (or Submit Extension / NPM Package)
  2. In the Submit for dropdown, select the desired sub-organization (or leave as the default parent org)
  3. Complete the rest of the submission form and click Start Analysis

The repository will be associated with the selected sub-org and will count toward the parent organization's quota.

Filtering the Dashboard by Sub-Organization​

The dashboard supports filtering repositories by sub-org:

  1. From the Dashboard, use the Organization filter dropdown above the repository list
  2. Select:
    • All Organizations — shows all repositories you have access to
    • Parent Org — shows only repositories not assigned to any sub-org
    • A specific sub-org name — shows only that sub-org's repositories

Each repository card displays a sub-org badge when it belongs to a sub-org.

BYOK (Bring Your Own Key) per Sub-Organization​

Parent org admins can assign a dedicated Anthropic API key to each sub-org. When set, scans for that sub-org will use the sub-org's key instead of the parent org's key.

Key resolution waterfall: sub-org key → parent org key → MSP key → platform key

Setting a Sub-Org BYOK Key​

  1. Go to Settings → Sub-Organizations
  2. Expand the sub-org management panel
  3. Open the BYOK tab (visible to parent org admins only)
  4. Enter your Anthropic API key and click Save

Removing a Sub-Org BYOK Key​

In the same BYOK tab, click Remove Key to revert to the parent org's key.

note

BYOK per sub-org is only available on plans that support BYOK.

Branding per Sub-Organization​

Sub-organizations can have their own logo displayed in reports and shared links, if the parent org admin enables this feature.

Enabling Sub-Org Branding​

Parent org admins can enable sub-org branding:

  1. Go to Settings → Sub-Organizations
  2. Toggle Allow Sub-Org Branding to on

Once sub-org branding is enabled, sub-org admins can upload a logo:

  1. Open the sub-org management panel
  2. Open the Branding tab
  3. Upload a logo image (PNG, JPG, or GIF, max 5 MB)
  4. Click Save

Branding resolution: sub-org logo → parent org logo → MSP logo

Archiving a Sub-Organization​

Archived sub-orgs are hidden from the dashboard and no longer accept new submissions.

  1. Go to Settings → Sub-Organizations
  2. Click Archive next to the sub-org
  3. Confirm the action
note

Archiving is a soft delete — existing repositories and data are preserved. Only parent org admins can archive sub-orgs.

Troubleshooting​

"Sub-organizations" section not visible in Settings

  • This feature is only available on Tier 3 and Alpha plans. Contact support to upgrade.

"Cannot add member" error

  • The user must already be a member of the parent organization, or you need to invite them by email.
  • Cross-organization member additions are not permitted.

"Cannot submit to sub-org" error

  • The sub-org may be archived. Unarchive it before submitting.
  • Confirm your plan tier supports multi-tenancy.

For additional help, see Contact Support.