---
lang: en
---

# Teamspace

A teamspace is the team your account works in on Cactus, with its name, its members and the email domains that let colleagues join. Each account belongs to one teamspace. Owners run it on the Teamspace page; other members see the same page without the controls.

> Verified against the product on 2026-11-14

## Rename the teamspace

Only an owner can rename the teamspace, and the name holds up to 60 characters.

A new teamspace is named for its first owner, as in "Nour's teamspace".

1. In [Teamspace](https://app.heycactus.ai/team), type the new name in **Name**.
2. Select **Save**. The new name shows to every member. **Save** stays off while the name is blank.

## Change a member's role

Only an owner can change a role. The **Role** menu offers **Owner** and **Member**.

1. In [Teamspace](https://app.heycactus.ai/team), open the **Role** menu beside the member and choose **Owner** or **Member**.

> **Note:** The only owner of a teamspace has its role menu and its **Remove** button switched off, and it says "A teamspace needs at least one owner".

## Remove a member

Only an owner can remove a member, and the only owner cannot be removed.

1. In [Teamspace](https://app.heycactus.ai/team), select **Remove** beside the member.

Removing a member also clears their pending request to join and revokes the AI client access they hold for this teamspace.

## Add an email domain

An owner can add only the domain of a verified email that they sign in with.

1. In [Teamspace](https://app.heycactus.ai/team), select **Add** followed by your domain, under **Email domains**. The button appears only while your own domain is not listed yet.
2. Add the TXT record shown beside the domain to that domain's DNS. Its value is `cactus-verification=` followed by a token Cactus makes for the domain.
3. Select **Check record**. The domain shows **Verified** once Cactus finds the record there.

Only owners see the record, and only while the domain is not verified.

## Who can join

Once a domain is verified, the **Who can join** section appears, with two choices for people who sign in on that domain. A new teamspace starts on the approval choice.

| Choice on the screen | What happens |
| "Anyone with a @_domain_ address joins on sign-in." | The person joins the teamspace as they sign in, with no request. |
| "Colleagues ask, and an owner lets them in." | The person asks to join, and an owner approves or denies it under **Requests**. |

Joining by domain works only for a sign-in with a Google Workspace account on that domain. A consumer address does not count.

## Requests to join

Owners see people who asked to join by domain, each with **Approve** and **Deny**.

1. In [Teamspace](https://app.heycactus.ai/team), select **Approve** beside the person to let them in, or **Deny** to turn the request away.

Approving makes the person a member and emails them. Cactus emails the owners when a request comes in, and once more if nobody has answered.

> **Note:** If the person already belongs to another teamspace, the approval is refused and the request stays pending.

## Invite by email

Owners can invite anyone by email, whatever the address's domain.

1. In [Teamspace](https://app.heycactus.ai/team), enter the address in **Email** and choose a **Role**: **Member**, which is picked first, or **Owner**.
2. Select **Send invite**. The person gets an email with a link to accept, which works for 7 days.

> **Note:** Sending to an address that already has a pending invitation replaces that invitation with a new link, its role and 7 days.

Pending invitations are listed under **Invitations** with their role and the days left. Select **Cancel** to end one.

## Accept an invitation

The person who was invited accepts it after signing in with the invited address.

1. Open the link in the invitation email. Cactus accepts the invitation as the page opens.
2. Or sign in with the invited address. On [Welcome](https://app.heycactus.ai/welcome), select **Accept invitation**. Select **Not now, make my own teamspace** to decline it.

An account can hold only one teamspace, so accepting an invitation while on another teamspace is refused.

## What members see

Members who are not owners see the same page without the controls.

- The name, which they can read but not change.
- Each member's role as plain text, with no menu.
- Each email domain and whether it is **Verified**, with no **Remove**, **Check record** or record.
- No **Who can join**, **Requests** or **Invitations** sections.

## If something doesn't work

| What you see | What it means | What to do |
| "This invitation has expired. Ask for a new one." | The link is more than 7 days old, or it was declined, accepted or cancelled. | Ask an owner for a new invitation. |
| "This invitation was sent to _a masked address_. Sign in with that account." | You are signed in with a different address. | Sign in with the invited address. |
| "You already belong to _your teamspace_. Cactus supports one teamspace per account for now." | Your account is already on a teamspace. | Sign in with an account that is on no teamspace. |
| "Already a member" | The address is already on this teamspace. | Find the person under **Members**; nothing needs sending. |
| "Saved, but the email didn't go" beside an invitation | The invitation is saved, but its email was not sent. | Select **Send invite** again for that address. |
| "The record isn't on _domain_ yet. DNS changes can take a few minutes to show." | Cactus checked before the record showed in DNS. | 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 in a minute. |
| "That domain already belongs to another teamspace" | Another teamspace has verified this domain, and a domain verifies for one teamspace only. | The other teamspace's owner must remove the domain first. |
| "_Your teamspace_ no longer proves _domain_ in DNS, so it can't be joined by email domain. Ask an owner to invite you." | The record was removed from DNS, so joining by domain is off. | An owner adds the record back, then selects **Check record**. |
| "Your request wasn't approved. Ask a teamspace owner to invite you." | An owner denied the request, and a new one cannot be sent. | Ask an owner to invite you by email. |
| "They already belong to another teamspace." | The person you tried to approve is on another teamspace. | Nothing is approved; the request stays pending. |
