Organizations
Group your projects under tenant-scoped organizations, switch the active organization to scope the Projects workspace, share an organization at Read, Write or Admin, and manage each organization's name and slug
Organizations are tenant-scoped containers that group your projects. The active organization scopes the Projects workspace, so switching organizations switches which projects you see and work in. Manage them under Admin → Organizations, in the Platform section of the Admin sidebar.

Each row shows an organization's name and slug, with the active organization marked. The header switcher (top) reflects the same active organization.
Admin → Organizations opens to anyone who holds View every organization and project or Create organizations, or who is Admin on at least one organization, so whoever creates an organization can always reach it. Anyone else who opens it is returned to Projects. On the page, creating an organization needs Create organizations, and renaming, deleting and sharing one need Admin access to it: a row you don't administer is read-only. Anyone can still switch between the organizations they can see from the header org switcher. Permissions come from the roles assigned under Admin → Access.
How organizations fit in
A tenant can hold many organizations, and each organization groups its own projects. Exactly one organization is active at a time. It scopes the Projects plane and also the Skills library and tool-server grants, so switching organization changes what the Admin plane shows you as well as which projects you see. The choice is remembered across sessions.
- Tenant → organizations → projects — organizations sit between your tenant and your projects. Creating projects requires an organization to put them in.
- Active organization — the organization currently in context. It carries a Current badge in the list and its name appears in the header org switcher.
- Identity — every organization has a name and a slug, each unique within the tenant. Two names are told apart by more than case, symbols or extra spaces.
- Only what is shared with you — the org switcher, the Projects plane and this page list an organization you hold a level on, or one holding a project shared with you, which then shows only the projects you can read in it. Platform Admins, and the holders of View every organization and project or Administer every organization, see every one.
Organizations live entirely within your tenant — they are an internal way to structure projects, not a billing boundary or a separate login. Switching the active organization never changes your tenant or your sign-in.
Switching the active organization
The active organization is shown in the org switcher in the top header — the button labelled with the active organization's name. Open it to move between organizations without leaving the page.

The org switcher lists every organization you can see and marks the active one with a check; the New organization item jumps to the Organizations page with the create dialog open.
You can switch the active organization two ways:
- From the header switcher — open it and choose an organization.
- From the Organizations page — click any organization's name to make it active.
Switching the active organization reloads the Projects workspace, and the Skills library with it — both are org-scoped, so the Admin plane changes under you as well as the Projects plane. The switcher appears only once you can see at least one organization.
Creating an organization
Creating an organization needs Create organizations, which Administer every organization includes. Whoever creates one is its Admin. Click New organization — the button on the Organizations page or the shortcut at the bottom of the header org switcher — or, on the Admin plane, choose Create → Organization at the right of the top header, to open the create dialog. The switcher and the Create menu show their entries to every holder of Create organizations, and to nobody else.

The slug is derived from the name as you type; you can override it before creating.
Open the create dialog. Click New organization. The dialog explains that an organization groups your projects.
Enter a name. Type the organization's display Name (for example, Acme Partners). It must differ from the name of every other organization in your tenant by more than case, symbols or extra spaces, so acme partners is refused where Acme Partners exists. As you type, AskRAI derives a URL-safe Slug automatically.
Adjust the slug (optional). Edit the Slug if you want a specific value. It may contain only lowercase letters, numbers, dashes, and underscores. Leave it as derived, or blank, to let AskRAI generate one from the name and guarantee it is unique.
Create. Click Create. The new organization is added, becomes the active organization, and a confirmation appears. The header switcher updates to show it.
Organization fields
| Field | Description | Required |
|---|---|---|
| Name | The organization's display name, shown in the list and the header switcher. Unique within the tenant, whatever its case, symbols or extra spaces | Yes |
| Slug | A URL-safe identifier, unique within the tenant. Lowercase letters, numbers, dashes, and underscores only. Auto-derived from the name; unless you type one on create, AskRAI generates and de-duplicates it | No (auto-generated) |
Slugs must be unique within your tenant, and an organization keeps its slug when renamed. If you type a slug that's already taken, the Slug field reads Organization slug '…' already exists for this tenant — pick another. When you leave the derived slug as it is, or blank, AskRAI appends a numeric suffix (-2, -3, …) if needed to keep it unique, so the slug created may differ from the one shown.
Editing and deleting
Each organization row has an actions menu (the ⋮ button) with Share, Edit and Delete. Editing and deleting an organization need Admin access to it: for anyone else Edit and Delete are held, saying they need Admin access to this organization.

Delete asks for confirmation, and is held while the organization still holds projects — delete those first.
Edit an organization
Choose Edit to open the edit dialog, where you can update the Name and Slug. A new name is held to the same rule as on create, while the organization's own name always saves, in another case too, as does a name two organizations already shared. The slug is required when editing and must stay unique within the tenant. Click Save changes to apply. Only the field you changed is saved, so another admin's change to the other field stands; if you changed nothing, the dialog closes without saving.
Delete an organization
Choose Delete to open a confirmation dialog titled Delete organization?. It first checks whether the organization still holds projects. When it holds none, the dialog warns that the deletion is permanent and cannot be undone; click Delete to confirm.
You can't delete an organization that still has projects. The dialog says how many it holds, and Delete stays unavailable until you delete them. If a project is created in the organization while the dialog is open, AskRAI refuses the deletion with Organization has projects and cannot be deleted, and the dialog then shows the count.
Deleting an organization deletes the grants that shared it.
Access levels
An organization is shared the way a project is: its Admins grant a person, a group or everyone in your tenant Read, Write or Admin. Each level includes everything the one before it allows.
| Level | Adds |
|---|---|
| Read | See the organization, its row on this page and who it is shared with, in its Share dialog. Its projects only as each is shared with you |
| Write | Create projects in it, each one its creator's to administer |
| Admin | Rename, delete and share the organization, and change or remove its grants. Admin on every project in it |
Read and Write on an organization reach none of its projects: each of those is shared on its own, from its own Share dialog. Only Admin on the organization carries down to every project in it, including projects created after the grant.
An organization you hold no level on is hidden from you, unless it holds a project shared with you: then it shows with only the projects you can read in it. Without Write on an organization, New project in it is held, saying creating a project needs Write access to this organization.
Where your level comes from
Your level on an organization is the highest of:
- Platform Admin. A Platform Admin holds Admin on every organization.
- Administer every organization. A role holding this permission gives Admin on every organization, and so on every project. View every organization and project gives Read on each. Both are assigned through roles on Access.
- A grant to you.
- A grant to a group you are in. A group that is inactive grants nothing, and deleting a group removes its grants. Because a group's members hold its grants, changing who is in a group shared with an organization needs Admin on that organization.
- General access. The level the organization gives everyone in your tenant, if any.
A few rules follow:
- Whoever creates an organization is its Admin. Creating it grants them Admin, a grant like any other that an Admin can change or remove.
- Organizations from before sharing have no grant. None was given to anyone, so until a Platform Admin or a holder of Administer every organization shares one, only they can rename, delete or share it, nobody else creates a project in it, and anyone else sees it only to reach a project shared with them. Share each organization at Write with the people who should create projects in it before they sign in, and see projects from before sharing for the projects already in it.
- One grant each. A person or group holds at most one grant on an organization. Giving them another level changes the one they have.
- A change holds at once. AskRAI checks the level on every change anyone makes, so a grant you lower or remove stops working on that person's next action.
Read-only rows
Who opens Admin → Organizations is a wider set than who can change each organization on it: the holders of View every organization and project and Create organizations, and the Admins of any one organization. The page lists only the organizations you can see, and each row follows your level on that organization. A row you don't administer is read-only: its Edit and Delete are held, saying they need Admin access to this organization, and its Share dialog shows who the organization is shared with, read-only, when you hold Read or above on it. New organization is held for anyone without Create organizations, saying it needs that permission.
Sharing an organization
Choose Share in an organization's actions menu (the ⋮ button) to open its dialog. Only the organization's Admins can change anything in it: below Admin, it shows who the organization is shared with, read-only.

Admin on an organization is Admin on every project in it; Read and Write reach none of its projects.
Review who has access. The dialog lists each person and group the organization is shared with, each with its level, then General access, then Also has access: the holders of Administer every organization and of View every organization and project, and the tenant's Platform Admins. Their access comes from their roles, so this dialog does not change it.
Add people or groups. Search in Add people or groups, pick a person or group from your directory, choose Read, Write or Admin, and add them.
Change or remove a grant. Pick another level in a grant's level select, or remove the grant with its remove control. A removal asks you to confirm first, naming who loses which level, since getting it back means adding them again.
Set General access. Under General access, choose what everyone in your tenant holds: No access, Read, Write or Admin. Anyone who holds more through a grant of their own keeps the higher level. Choosing No access asks you to confirm first.
Granting Admin on an organization gives Admin on every project in it: its grantee can share, reset and delete any of them and decide their proposals. Give Write to someone who should create projects in it, and Read to someone who should only see it.
An organization with no Admin grant can still be shared by the holders of Administer every organization and the Platform Admins. Each grant made, changed or removed is recorded in the Change Log under Access, naming the organization, who it was given to and the level.
Troubleshooting
| Symptom | Likely cause | Resolution |
|---|---|---|
| You see no organizations or projects, and Projects reads Nothing is shared with you yet | No organization or project is shared with you, and you hold no role reaching every organization or project | Ask one of the Platform Admins the message names to share an organization or a project with you, then reload the page |
| The org switcher isn't in the header | The tenant has no organizations yet, or none is shared with you | Create your first organization, or ask a Platform Admin to share one with you; the switcher appears once you can see one |
| Opening Admin → Organizations redirects to Projects | You hold neither View every organization and project nor Create organizations, and are Admin on no organization | Ask an organization's Admin to share it with you at Admin, or ask for a role holding one of those permissions on Admin → Access |
| The header org switcher has no New organization shortcut | You don't hold Create organizations | Ask for a role holding it, or ask someone who holds it to create the organization |
| New organization is held | You don't hold Create organizations | Ask for a role holding it, or ask someone who holds it to create the organization and share it with you at Admin |
| Edit or Delete on an organization is held, saying it needs Admin access | Your level on that organization is below Admin | Ask one of its Admins, a holder of Administer every organization or a Platform Admin to make the change, or to share it with you at Admin |
| The Share dialog shows who has access, but nothing in it can be changed | You hold less than Admin on the organization | Ask one of its Admins, a holder of Administer every organization or a Platform Admin |
| An organization is shared with you, but its projects are missing from your list | You hold Read or Write on the organization, which reaches none of its projects | Ask for Admin on the organization, or for a grant on each project from its Share dialog |
| New project is held, saying it needs Write access to this organization | You hold Read on the organization, or see it only through a project shared with you | Ask one of its Admins, or a Platform Admin, to share it with you at Write, then reload the page |
| Slug reads Organization slug '…' already exists for this tenant, and Create or Save changes is disabled | Another organization in the tenant already uses the slug you typed, perhaps one renamed since it took it | Choose a different slug, or on create clear it to have AskRAI generate a unique one |
| Name reads An organization named '…' already exists, and Create or Save changes is disabled | Another organization in the tenant goes by that name, differing at most in case, symbols or extra spaces | Choose a name that differs by more than that. The organization the message names may not be one you can see |
| Delete organization? says the organization still holds projects, and Delete is unavailable | The organization still contains projects | Delete its projects, then delete the organization |
| Projects look wrong after switching | A different organization is active | Confirm the active organization in the header switcher — the Projects workspace is scoped to it |
Related pages
- Sharing & Access — share a single project, and see what each level on it decides
- Access — the roles that create, view or administer every organization and project
- Users, Roles & Groups — manage who can access the platform alongside how work is organized
- Directory Sync — provision users and groups from your identity provider
- Admin — the rest of the platform configuration