---
lang: en
---

# Team

A team is the group of people who share one Cactus teamspace, each as an owner or a member. Owners invite people, add and verify email domains, choose who can join and change roles, while members can see the team but change nothing on its page.

> Verified against the product on 2026-11-20

## Roles on a team

A team has two roles, Owner and Member, and each person on it has one of them.

| Role | What it shows | What it can change |
| --- | --- | --- |
| Owner | Every section of the team page, including **Who can join**, **Requests** and **Invitations**. | The team name, members and their roles, email domains, who can join, requests and invitations. |
| Member | The team name, the members with their roles, and the email domains. | Nothing on this page. |

Only an owner can make a change here. Anyone else who tries gets “Only a teamspace owner can do that.”

A person can belong to one team at a time. Accepting an invitation while already on a team fails with “You already belong to _the team’s name_. Cactus supports one teamspace per account for now.”

## Invite people

Only an owner can send an invitation.

1. In [Team](https://app.heycactus.ai/team), find **Invitations** and enter the person’s address in **Email**.
2. Choose **Role**. **Member** is the choice already made, and **Owner** is the other.
3. Select **Send invite**. The person gets an email with a button that accepts the invitation, and the invitation works for 7 days.

> **Note:** Inviting an address that already has an invitation replaces it, with a new link, the chosen role and a new 7 days.

Pending invitations stay in the list until they are accepted, declined or cancelled. Each shows its role and “expires in N days”, and one past its date shows “expires in 0 days”. Select **Cancel** beside one to delete it.

The invitation must be accepted by the account whose address it was sent to.

## If an invitation doesn’t work

| What you see | What it means | What to do |
| --- | --- | --- |
| “Invite saved, but its email didn’t send. Cancel it and invite them again to resend.” | The invitation exists, but its email did not go out. | Select **Cancel** beside it, then send the invite again. |
| “That person is already a member.” | The address already belongs to someone on the team. | Nothing to send. Find them under **Members**. |
| “Enter an email address.” | The address has no `@` and no domain after it. | Type a full address. |
| “This invitation has expired. Ask for a new one.” | The link is past its 7 days, was cancelled, or was already accepted or declined. | Ask an owner to invite you again. |
| “This invitation was sent to _the masked address_. Log in with that account.” | The link was sent to another address than the one you are signed in with. | Log in with the address the invitation was sent to. |

## Add an email domain

Only an owner can add an email domain, and the one offered is the domain of the address the owner signs in with. The owner’s address must be verified for the button to show.

1. On the team page, under **Email domains**, select **Add** with your domain, shown as **Add _your domain_**.
2. The domain shows a TXT record in a box with a copy button. Add that record to the domain’s DNS, then select **Check record**.

Once Cactus finds the record, the domain shows **Verified**. Select **Remove** beside a domain to delete it.

A domain that one team has verified cannot be verified by another.

| What you see | What it means | What to do |
| --- | --- | --- |
| “The record isn’t on _the domain_ yet. DNS changes can take a few minutes to show.” | Cactus did not find the TXT record when it checked. | Wait a few minutes, then select **Check record** again. |
| “Cactus couldn’t reach DNS just now. Try again in a minute.” | The DNS lookup failed. | Select **Check record** again. |
| “That domain already belongs to another teamspace.” | Another team has verified the domain. | Only one team can hold a domain. |
| “This record was gone from _the domain_ when someone tried to join, so joining by email domain is off. Add it back, then check it.” | When someone tried to join by this domain, the record was missing, and Cactus turned verification off. | Add the record back to the domain’s DNS, then select **Check record**. |

## Who can join

Only an owner sees **Who can join**, and only once the team has at least one verified domain.

> **Note:** A new team starts on **Colleagues ask, and an owner lets them in.**

The two choices are:

- **Anyone with a @_domain_ address joins when they log in.** This is the open choice.
- **Colleagues ask, and an owner lets them in.** This is the approval choice.

Choosing one saves it straight away. How people then join is told on [Joining a team](https://cactus.heycactus.ai/55b9rk-joining-a-team).

### Requests

Owners see the pending requests under **Requests**, each with “asked” and how long ago.

- Select **Approve** to add the person as a Member. Cactus then emails them.
- Select **Deny** to refuse the request. The person then sees “Your request wasn’t approved. Ask a teamspace owner to invite you.”

Approving fails with “They already belong to another teamspace.” when that person has joined another team since asking. Each new request emails the owners.

## Change roles and remove members

Only an owner can change a role or remove a member. The **Role** choice on each member offers Owner and Member.

A team always keeps at least one owner. The last owner’s role choice and **Remove** are disabled, with the note “A teamspace needs at least one owner”.

Select **Remove** beside a member to take them off the team. Their pending join requests for the team are deleted, and their AI client connections for the team are revoked. The revoked connections are listed under [AI clients](https://cactus.heycactus.ai/766ch7-ai-clients).

If a change does not save, the page shows “Couldn’t update this teamspace. Try again.”

## Rename the team

Only an owner can rename the team. Under **Teamspace**, enter a **Name** of up to 60 characters and select **Save**. Members see the name as plain text.

The name is required, and the form does not save while it is empty.
