> For the complete documentation index, see [llms.txt](https://docs.imerit.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.imerit.net/core-concepts/organizations.md).

# Organizations

Overview of organizations and organization management on Ango Hub

<figure><picture><source srcset="https://angohub-docs-assets.s3.eu-central-1.amazonaws.com/cover/organizations-dark.png" media="(prefers-color-scheme: dark)"><img src="https://angohub-docs-assets.s3.eu-central-1.amazonaws.com/cover/organizations.png" alt=""></picture><figcaption></figcaption></figure>

Organizations are the main way users are organized within Ango Hub. In short, organizations are groups of users with access to the same projects and plugins.

## Quick Facts About Organizations

* All users are always part of at least one organization. It is not possible for a user to not be part of an organization.
* You can belong to more than one organization at the same time.
* Plugins are managed organization-wide. That is, if you have activated a plugin while you were part of Org A, the plugin is active for all users of Org A.
* It is not possible to have a project shared between two organizations.
* The only way to join an existing organization is through an invite sent by an administrator of the organization you wish to join.

## Creating an Organization

### When Signing Up

If you signed up to Ango Hub independently, without having received an invite from an existing user, you have created an organization with a name equal to what you wrote in the *Company Name* field during signup.

![](https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTcOUG6rfWxqGM0N4db2P%2Fuploads%2FLPxIY0C873goryfvuZ5r%2Fimage.png?alt=media\&token=2e20b1db-8dff-4760-bdec-d946def56479)

An organization with the same name as your company has been created for you automatically, and you have been added as its first and only user.

### After Having Signed Up (From the Organization Switcher)

To create a new organization, click on the name of your organization at the top-right corner of the screen, then click on "New Organization".

<figure><img src="https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTcOUG6rfWxqGM0N4db2P%2Fuploads%2Fivnf2g5COqQIiJEWeyco%2Fimage.png?alt=media&amp;token=f7fc3856-6bc9-473a-970f-f5aa57453bb0" alt=""><figcaption></figcaption></figure>

You will be prompted to input the name of your new organization. Once you have entered it and clicked on OK, you will be switched to your new organization.

{% hint style="info" %}
If you receive a warning that you are not able to create further organizations, it likely means you are on the free plan and have run out of organizations to create. [Get in touch with our team](https://ango.ai/get-demo/) to upgrade.
{% endhint %}

### Via Invitation

If you signed up to Ango Hub via clicking on an email invite, you have automatically been added to the inviter's organization. No further action is required on your part.

If you are already signed up and logged into Ango Hub, and you receive an invitation to join an organization, you may click on the Hub notification or on the email link to join the new organization.

You will not be removed from your old organization.

## Switching Organizations

If you are part of more than one organization, you may switch between your new and old organization through the *Organization Switcher* from the top-right corner of the screen, by clicking on your current organization, then on the name of the organization you'd like to switch to.

<figure><img src="https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTcOUG6rfWxqGM0N4db2P%2Fuploads%2FwoEiFa7bV9DE9f525nPY%2Fimage.png?alt=media&amp;token=8c971d4f-1baf-4191-9bce-a2f98157878e" alt=""><figcaption></figcaption></figure>

## Users and Roles in Organizations

You can invite as many users to your organization as your plan allows.

Every user will have either the *admin* or the *member* role.

### Organization-Level Roles

* **Admins** can see all projects and all data within projects. Admins can also invite and remove users, and can change the organization- and project-level roles of all other users. Admins can also see organization-level statistics and plan usage.
* **Members** can only see the projects they have been assigned to. In projects, they only see data according to the project-level role they have been assigned to. They cannot manage or invite other users, nor can they see plan usage and org-level statistics.

### Inviting new users to your organization (Admin only)

Click on the *Organization* link in the top bar. You will be brought to your organization's dashboard. From this dashboard you can manage members of your organization.

![](https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTcOUG6rfWxqGM0N4db2P%2Fuploads%2FR4dF7RjglCssy5jb39sZ%2Fimage.png?alt=media\&token=7f355b3b-dbae-41ca-a0b7-8c28388d2780)

In *Members*, click *Invite Member*. In the dialog that pops up, enter the email of the member(s) you'd like to invite, as well as the org role you'd like them to take on. [See more on roles here](https://docs.imerit.net/core-concepts/user-roles.md). You may add multiple members at once quickly by copy-pasting a list of comma-separated email addresses.

You may also expand the *Pre-add Users to Projects* dropdown to also pre-add them to projects, in different roles. When the users you invited accept their invitations, they will automatically be added to the projects you picked here.

<figure><img src="https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTcOUG6rfWxqGM0N4db2P%2Fuploads%2Fgit-blob-de1eb00373e4402da898b847ce73f14fe800b23e%2Fango-organization-invite.jpg?alt=media" alt="Invite Organization Members form with Organization Role and the expanded Pre-add Users to Projects section"><figcaption></figcaption></figure>

To send invitations in bulk, open *From CSV*. Use *Sample CSV* to format your file, upload it, and click *Review* to check the email addresses and roles before sending.

<figure><img src="https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTcOUG6rfWxqGM0N4db2P%2Fuploads%2Fgit-blob-56f083d2bb828d0972e2ec4f7b12f73d7c9597f0%2Fango-organization-invite-csv.jpg?alt=media" alt="Organization invitation dialog on the From CSV tab, with Sample CSV and Review"><figcaption></figcaption></figure>

An email will be sent with an invitation link to the email you entered. Once the user you invited clicks on the link and signs up, they will appear as members in your organization.

To resend all pending organization invitations, click *Resend Invitations* from the invitations list. Ango Hub will ask you to confirm before sending the new invitation emails.

{% hint style="info" %}
If the user you are inviting is already signed up to Ango Hub, they will receive an email with a link to sign in to their profile and a notification allowing them to switch to your organization. Invitations sent this way have no expiration date.

If the user you are inviting is not already signed up to Ango Hub, they will receive an email with a link to sign up to Ango Hub. Once they signed up, they will receive a notification they will need to click to switch to your organization.
{% endhint %}

### Managing Organization Users

{% hint style="warning" %}
If an admin has added plugins to the organization, changing that user's role to member, or removing them from the org, will also remove their plugins from the org.
{% endhint %}

From the *Organization* page, you can change a member's status, as well as remove them from the organization entirely from the three-dot menu on each members' row:

Before removing a member, Ango Hub shows their email address and explains that they will lose access to the organization and its projects. If the member has added plugins, a second confirmation lists the affected plugin connections before they are removed from the organization.

![](https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mj9Q2CMggO8ujraHZeP%2F-Mkax07HWpxc_WmPafmJ%2F-Mkb-8j14DPEXeT6z57F%2Fimage.png?alt=media\&token=27f6c101-9e08-4f19-a37c-4358b33630d3)

## Service Accounts

Service accounts let scripts and integrations use the API and Python SDK with keys owned by your organization. They cannot sign in to Ango Hub, do not appear in the Members list, and do not take a user seat.

Organization admins can manage them from the *Service Accounts* tab of the *Organization* page.

### Creating a Service Account

1. Click *Add Service Account*.
2. Enter a name and, optionally, a description of what the account is used for.
3. Select the scopes the integration needs, then click *Create*. Scopes control which operations the account can perform. For example, `projects:read` allows listing and reading projects, while creating a project requires `projects:write`.
4. Copy the key from *Save Your API Key* and store it securely, then click *I've Saved the Key*.

{% hint style="warning" %}
The full key is shown only once. If you lose it, create a new key from the account's *API Keys* action.
{% endhint %}

Use the key in the `apikey` header of API requests or as `api_key` when initializing the [Python SDK](https://docs.imerit.net/sdk/sdk-documentation.md). Requests are limited to this organization and the account's selected scopes. Changes made with a service account's keys are attributed to the account.

### Managing Access and Rotating Keys

Use *Edit* on the account's row to change its name, description, or scopes. Scope changes apply to its existing keys.

From *API Keys*, you can create and revoke keys. Each account can have up to two active keys. To rotate a key, create a new one, update your integration to use it, then revoke the old one. A revoked key stops working immediately and cannot be restored.

*Disable* stops requests made with all of the account's keys until you *Enable* it again. Deleting the account permanently stops its keys from working; changes it previously made remain attributed to it.

### Copilot Agents

Agents created in a project's [Copilot settings](https://docs.imerit.net/labeling/labeling-ai-assistance/copilot.md#how-to-set-up-copilot) also appear in *Service Accounts*, marked with a *Copilot* tag. This includes existing agents previously listed in the *Agents* tab.

Copilot agents have full access and keys managed by Ango Hub. You can disable, enable, or delete them here, but cannot edit their scopes or manage their keys. Disabling or deleting an agent prevents Copilot from working in projects that use it. Select an active agent in the project's Copilot settings to continue.

### Ango Plugin Runtime

When an admin installs a plugin, Ango Hub creates the *Ango Plugin Runtime* service account if your organization does not already have one. It appears in *Service Accounts* with a *Plugins* tag. The account has full access to your organization and does not take a user seat. Ango Hub manages the account and its key.

Installed plugins stay connected if the person who installed them leaves the organization or changes their personal API key.

## Removing Yourself from an Organization (Admin only) <a href="#adding-new-members-to-a-project" id="adding-new-members-to-a-project"></a>

At the present time, you can only remove yourself from an organization if you have admin privileges in the organization and you are not the owner (e.g. original creator) of the organization.

From the *Organization* page, click on the three dots next to your name and click on *Remove From Organization*.

![](https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTcOUG6rfWxqGM0N4db2P%2Fuploads%2FK0DcnEkahdh9r2EB1VcU%2FScreen%20Shot%202022-03-03%20at%2011.17.35.png?alt=media\&token=469ec0d5-1692-4347-9fb1-d072a6c42535)

{% hint style="info" %}
If you remove yourself from your only organization, you will be automatically added to a new organization called *Untitled Organization*.

This is because it is not possible for a user not to be part of an organization.
{% endhint %}

## Deleting an Organization

If you are the organization owner, you can delete your current organization.

To do so, from the *Organization* page, enter the *Danger Zone* tab and click on *Delete Organization* to start the process.

If you are an organization admin but not the owner, you can check who the owner is from the *Members* tab in the *Organization* page.

## Organization Statistics

You may access statistics related to your entire organization from the Overview tab of the Organization page:

<figure><img src="https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTcOUG6rfWxqGM0N4db2P%2Fuploads%2FfthaEIGIAxthY6xQfCvT%2Fimage.png?alt=media&amp;token=679f3027-e345-40f7-bc62-618225469151" alt=""><figcaption></figcaption></figure>

By default, Ango Hub displays organization statistics on a project by project basis, but you can switch to the *Users* tab to access user-by-user statistics and download a CSV of them by using the *Export* button:

<figure><img src="https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTcOUG6rfWxqGM0N4db2P%2Fuploads%2FzDagZFJWePNxZgG9vuYh%2Fimage.png?alt=media&amp;token=fe67347f-8744-4360-833a-ec503c32afb7" alt=""><figcaption></figcaption></figure>

## Sending a link to a specific organization

Normally, if you send someone a link to a project, if they are part of the organization the project is in, they will be asked to switch to the organization and then they'll be directed to the project.

However, if you wish to send a link to a specific organization without sending a project link, you may do so by sending the following link:

```
https://imerit.ango.ai/switch-org/YOUR_ORG_ID
```

Replace `YOUR_ORG_ID` with the ID of the organization you'd like the recipient to switch to. You can find your organization's ID in your "Account" page accessible by clicking on your avatar on the top-right corner:

<figure><img src="https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTcOUG6rfWxqGM0N4db2P%2Fuploads%2FAK9dzAlOqJjwQxwcyNm3%2Fimage.png?alt=media&amp;token=91e37f55-f5ff-48a6-a0b4-7910b4ed1d9f" alt="" width="375"><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.imerit.net/core-concepts/organizations.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
