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

# Members and invitations

> Invite people to a BotGauge organization or workspace, understand the 7-day invitation lifecycle, and change or remove access without losing history.

People join BotGauge through an invitation or, if they already belong to your organization, by being added to a workspace.

## Invite someone to the organization

An org owner or admin opens **Organization, Members** and chooses **Invite member**, then enters one or more email addresses, picks a role, and sends the invitations. Each person receives an email.

![The Organization Members table with roles, workspaces, and last active time](https://mintcdn.com/botguage/CvMAYy1jOk7D5CuB/images/platform/organization-members.jpg?fit=max\&auto=format\&n=CvMAYy1jOk7D5CuB\&q=85\&s=8aab095bba577d8ff0d82ee2c9156ed7)

Organization, Members.

![The Invite members dialog with email addresses, role, and workspace choices](https://mintcdn.com/botguage/CvMAYy1jOk7D5CuB/images/platform/invite-members.jpg?fit=max\&auto=format\&n=CvMAYy1jOk7D5CuB\&q=85\&s=dfba3b73bcf4689b65e239e36df015ab)

Invite members: choose a role and, for Members, at least one workspace.

| Invite as | Workspaces |
| - | - |
| Admin | Leave blank. Admins get every workspace. |
| Member | Pick at least one workspace, and a workspace role for each. |

Invitations are valid for 7 days. When the person accepts, they join the organization with the invited role and are added to the chosen workspaces.

## Invite someone into one workspace

A workspace admin can add people who are already in the organization, or invite someone new into their workspace. Someone new always joins the organization as a Member, with the workspace role chosen in the invitation. Adding an existing org member sends no email, and access applies immediately.

![The Workspace Members table](https://mintcdn.com/botguage/CvMAYy1jOk7D5CuB/images/platform/workspace-members.jpg?fit=max\&auto=format\&n=CvMAYy1jOk7D5CuB\&q=85\&s=b013c0a2a895e85d61fb85e35dce79a4)

Workspace, Members.

![The Add people dialog for a workspace with a role selector](https://mintcdn.com/botguage/CvMAYy1jOk7D5CuB/images/platform/add-people-to-workspace.jpg?fit=max\&auto=format\&n=CvMAYy1jOk7D5CuB\&q=85\&s=925bb779d07e5fc8cf3295cdb6e26120)

Add people from the organization and choose their workspace role.

## What the invited person does

The email links to an invitation page. The invited person signs in with the same email address the invitation was sent to, with that email verified, and then accepts or declines.

| Situation | Result |
| - | - |
| Accepted | The person joins the organization and the invited workspaces. The link stops working. |
| Declined | The invitation is marked declined and the link stops working. |
| Older than 7 days | The invitation is expired. Ask an admin to resend it. |
| Signed in with a different email | Sign out and sign in with the invited address. |
| The organization requires SSO | Sign in through the organization's SSO first. |
| The organization or workspace was deleted after the invitation was sent | The invitation can't be accepted. |

People can also see and accept their pending invitations from inside the console after signing in, without using the email.

## Manage pending invitations

Pending invitations appear as rows in the Members table. An admin can **Resend** or **Cancel** each one.

Resending emails a new link, extends validity by another 7 days, and invalidates the previous link, so only the newest link works. It also works for expired invitations. Resending twice within a minute is refused. Canceling withdraws the invitation and the link stops working immediately.

## Change someone's access

| To do this | Who can | Where |
| - | - | - |
| Change a person's organization role (Admin or Member) | Org owner or admin. Only an owner can grant or change the owner role. | Organization, Members |
| Choose which workspaces a Member belongs to | Org owner or admin | Organization, Members, Edit |
| Change a person's workspace role (Admin, Member, or Viewer) | Workspace admin or org admin | Workspace, Members |

![The Workspace access dialog with workspaces and a role for each](https://mintcdn.com/botguage/CvMAYy1jOk7D5CuB/images/platform/workspace-access.jpg?fit=max\&auto=format\&n=CvMAYy1jOk7D5CuB\&q=85\&s=c89d8380b7a5d0b642e78a0c4c7db0d8)

An org admin chooses a member's workspaces and a role in each.

![The workspace role dropdown with Admin, Member, and Viewer](https://mintcdn.com/botguage/CvMAYy1jOk7D5CuB/images/platform/change-workspace-role.jpg?fit=max\&auto=format\&n=CvMAYy1jOk7D5CuB\&q=85\&s=e411e9d30645b9a26f6e0114e0561081)

A workspace admin changes a role from the Members page.

When you save a member's workspace access, send the complete list. Workspaces you leave out are removed from the person, and saving an empty list removes them from every workspace while keeping them in the organization. Org admins are Admin in every workspace, so their workspace access can't be edited.

## Remove someone

Removing a person from the **organization** takes them out of every workspace in it, and their personal tokens stop working. If you invite them again within 90 days, their history is restored. An organization must always keep an owner, so the only owner can't be demoted or removed. Only an owner can remove another owner.

Removing a person from a **workspace** ends their access to that workspace and its projects and stops their personal tokens for it, but they stay in the organization.

## Plan limits

The Free plan limits how many members an organization can have. Inviting beyond the limit is refused. See [Workspaces and projects](https://www.botgauge.com/docs/platform/workspaces-and-projects.md#plan-limits).

Send your first invitationOpen [BotGauge](https://cloud.botgauge.com) to invite members and manage workspace access.

[Try BotGauge →](https://cloud.botgauge.com)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.