Organizations

An organization is the top-level workspace in ByteHide. It holds your projects, members, teams, integrations, billing and security settings. One account can belong to several organizations and switch between them.


What Belongs to an Organization

ScopeExamples
PeopleMembers, their roles, teams and pending invitations
WorkProjects and the tools enabled in them (Code, Vault, Shield, App runtime, Audit), plus AI runtime and Agentic runtime
ConfigurationIntegrations, developer API tokens, SSO and SCIM
BillingPlan, subscriptions, invoices and usage. Each organization is billed on its own

Nothing is shared between organizations. A person who belongs to two organizations has a separate role in each.


Create an Organization

  1. Click your avatar in the top-right corner.
  2. Under Organization, click Add new organization.
  3. Fill in the form and click Create.
FieldDescription
Display NameThe name shown in the console and to invited members. Required
SlugURL-friendly identifier. It fills in from the display name as you type. Lowercase letters, numbers and single hyphens only. Required
DescriptionOptional, up to 255 characters

You become the Owner of the new organization, and ByteHide creates its default team, general. The console then opens its settings.

Owners only

Add new organization appears only when you are an Owner of the organization currently selected. Each new organization starts its own plan and trial.


Switch Organization

Click your avatar and choose an organization under Organization. The current one is marked. The console reloads with the projects, members and settings of the organization you picked.


Organization Settings

Open Settings → Organization. The menu on the left shows only the sections your role can use:

SectionWhat it holdsWho sees it
SettingsName, slug, description and avatarOwner, Manager
Teams & MembersTeams, members and invitations. See Members and TeamsEveryone (the members list needs Owner or Manager)
IntegrationsOrganization-wide connectorsOwner, Manager
DeveloperAPI tokens and authorized appsOwner, Manager
SecuritySSO, verified domains and SCIM. See Single Sign-OnOwner, Manager (only owners can change it)
BillingPlan, payment, billing address, billing emails and invoicesOwner, Billing
UsageConsumption per productOwner, Billing
Danger ZoneLeave the organizationEveryone

General Settings

In Settings → Organization → Settings, under Organization Settings:

  • Slug, Display Name and Description. Click Save changes to apply them, or Reset to discard your edits.
  • Avatar: click Upload an image (PNG or JPEG, up to 800 KB), or Remove to clear it.

Changing the slug

The slug is part of the SSO Sign-in URL shown in Security. If your organization uses SSO and you change the slug, update the Home page URL of the ByteHide app in Entra ID.


Ownership

The Owner role has full control of the organization, including billing, SSO and every member's role. An organization can have more than one owner, and it always keeps at least one:

  • Only an owner can make someone else an owner, by inviting them with the Owner role or changing an existing member's role.
  • You cannot change your own role or remove yourself from the members list.
  • The last owner cannot be removed or demoted, by another owner or by SCIM.

To hand an organization over, make the new person an owner first. Then they, or you, can change your role, or you can leave.


Billing Scope

Billing is per organization. The plan, subscriptions, payment method and invoices of one organization do not affect another. Only Owner and Billing roles can open Billing and Usage.

Your plan includes a number of members. On paid plans the Members tab shows how many are included and how many free seats remain. When there are none left, the invitation dialog warns that an extra member is charged once the invitation is accepted, and that this charge is not refunded.


Leave an Organization

  1. Open Settings → Organization → Danger Zone.
  2. Tick Understood and wish to proceed and enter a Reason.
  3. Click Leave Organization.

Leaving is permanent. To come back you need a new invitation. If you are the only owner, the page says "You are the only owner of this organization. Cannot leave organization." Make another member an owner first.


Delete an Organization

The console has no option to delete an organization. To delete one, contact ByteHide support from Support in the console.


Next Steps

Members and Teams

Invite people and assign roles

Projects

Create a project and pick its tools

Single Sign-On

Sign in with Microsoft Entra ID

Previous
Overview