heycactus.ai

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.

On this page

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

What it shows

Every section of the team page, including Who can join, Requests and Invitations.

What it can change

The team name, members and their roles, email domains, who can join, requests and invitations.

Member

What it shows

The team name, the members with their roles, and the email domains.

What it can change

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, 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.

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.”

What it means

The invitation exists, but its email did not go out.

What to do

Select Cancel beside it, then send the invite again.

“That person is already a member.”

What it means

The address already belongs to someone on the team.

What to do

Nothing to send. Find them under Members.

“Enter an email address.”

What it means

The address has no @ and no domain after it.

What to do

Type a full address.

“This invitation has expired. Ask for a new one.”

What it means

The link is past its 7 days, was cancelled, or was already accepted or declined.

What to do

Ask an owner to invite you again.

“This invitation was sent to the masked address. Log in with that account.”

What it means

The link was sent to another address than the one you are signed in with.

What to do

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.”

What it means

Cactus did not find the TXT record when it checked.

What to do

Wait a few minutes, then select Check record again.

“Cactus couldn’t reach DNS just now. Try again in a minute.”

What it means

The DNS lookup failed.

What to do

Select Check record again.

“That domain already belongs to another teamspace.”

What it means

Another team has verified the domain.

What to do

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.”

What it means

When someone tried to join by this domain, the record was missing, and Cactus turned verification off.

What to do

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.

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.

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.

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.

Sources

Related pages