---
title: "Accepting an invitation"
slug: account/invites
url: https://projectri.com/docs/account/invites
section: account
audience: everyone
app_route: "/join/[token]"
mobile: false
updated: 2026-09-08
source: Projectri documentation
---

# Accepting an invitation

What the join link does, why it insists on the address it was sent to, and what happens the moment you accept.

![Accepting an invitation](https://projectri.com/docs-shots/account-invites.png)

## What it is

An invitation email carries a link to `/join/<token>`. The page shows which
workspace is asking, who asked, what role you would get, and — if the invitation
also puts you on a project — which project and with what project role. One
button accepts it.

## How to get there

Open the link in the invitation email. The page itself is public: it renders
before anyone has signed in, because you need to see which workspace is asking
before deciding whether to create an account. It shows nothing the invitation
email did not already tell you.

## How to use it

### Accept when you already have an account

1. Open the link. If you are signed in as the invited address, the page shows
   your account in a strip with **Accept invite** beneath it.
2. Press **Accept invite**. You become a member, your session is switched to
   the new workspace, and you land in it.

### Accept when you do not have an account yet

1. Open the link. You are offered **Sign in to accept** and **Create account**.
2. Either takes you to `/login` with the invited address already filled in and
   the join link remembered, so you come straight back here afterwards.
3. Press **Accept invite**.

### When you are signed in as somebody else

The page says which address the invitation was sent to and which one you are
currently using, and the accept button is not offered — the server would refuse
it anyway. Press **Sign in as** the invited address to switch.

## What it affects

- **Your role in that workspace** is the one on the badge — Admin, Member,
  Viewer or Guest — and it applies only there. Your role in any other workspace
  is untouched. See [Roles and permissions](/docs/start/roles-and-permissions).
- **A project role, if the invitation carried one.** That is a second, separate
  grant, shown as its own badge, and the project's existing members are notified
  that you joined exactly as if an administrator had added you.
- **Your active workspace changes.** Accepting switches the session to the new
  workspace before navigating, so the app you land in is the one in the address
  bar. If you already belonged to another workspace, the **Workspaces** row in
  the rail is how you go back.
- **A seat is consumed.** This is the only place in the product where somebody
  who is not yet a member takes a seat, so the plan's seat cap is enforced
  here. A full workspace refuses the acceptance and says so.
- **The acceptance is audited** against the workspace being joined.

## On mobile

This screen is web only. Open the invitation link in a browser; once you are a
member, sign in to the workspace normally in the phone app.

## Limits and gotchas

- **An invitation lasts seven days.** After that the page says *"Invite
  expired"* and the only way forward is a fresh one from an administrator.
- **An invitation belongs to an address, not to whoever holds the link.** A
  forwarded invitation cannot be used by the person it was forwarded to. This is
  deliberate — the token travels by email, and email gets forwarded.
- **An invitation can only be used once.** A link that has already been accepted
  or cancelled reads *"This invite has already been used or cancelled"*.
- **The workspace's allowed-domain list is checked again at the moment you
  accept**, not only when the invitation was sent. An administrator who narrowed
  the list after sending it has said something about your invitation, and this
  is where it is honoured.
- If the invitation named a project that has since been deleted, the project
  half quietly drops off and the workspace half still stands.
- Cancelling an invitation is an administrator action from
  [Members](/docs/admin/members) — holding the token does not let you cancel it.

## Related

- [Signing in](/docs/account/sign-in) — creating the account the invitation is for.
- [Members](/docs/admin/members) — sending, resending and cancelling invitations.
- [Roles and permissions](/docs/start/roles-and-permissions) — what the role on the badge actually grants.
- [Workspaces](/docs/workspace/workspaces) — moving between workspaces once you are in more than one.

## Related

- [Signing in](https://projectri.com/docs/account/sign-in.md): Every way into Projectri — password, emailed code, Google, single sign-on and linking from a device you already trust — and what each refusal means.
- [Members](https://projectri.com/docs/admin/members.md): The workspace roster and the pending invite list — invite people, change roles, suspend, remove, and do any of those to many people at once.
- [Roles and permissions](https://projectri.com/docs/start/roles-and-permissions.md): The four workspace roles, the permission keys behind them, and why two people in the same workspace see different screens.
- [Your workspaces](https://projectri.com/docs/workspace/workspaces.md): Every workspace you belong to, which one you are in now, and how to switch between them or start one of your own.
