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

# Reviewers

> The people who answer: your directory of humans and groups, the reviewers of each workflow, and how to invite them by email, join code, QR code or link.

**Reviewers** are the people a workflow asks. Anyone with a HITL account can be one; they answer in the [mobile app](https://docs.hitl.sh/answering/mobile-app.md), the [web inbox](https://docs.hitl.sh/answering/web-inbox.md) or [Telegram](https://docs.hitl.sh/answering/telegram.md).

## Humans, groups and workflow reviewers

* **Humans** (in the sidebar of my.hitl.sh) is your directory: everyone you have invited, with their status (*Active* or *Invited*) and role.
* **Groups** sort them, for example *Support leads* or *On-call*. Everyone is in the default group, **Universe**. A review step can ask a group instead of naming people.
* Each workflow has its own **reviewers**, on its **Humans** tab. A review step with no people picked asks all of them.

![The Humans page listing five people with their group Universe, role Owner or Reviewer and status Active, with a Groups panel on the left and an Add human button](https://mintcdn.com/hitl/8U4JOCXRGxwTV383/images/app/humans.png?fit=max\&auto=format\&n=8U4JOCXRGxwTV383\&q=85\&s=0fc2e72c9a020863ba6ed73d1566e5c4)

## Inviting reviewers to a workflow

Open the workflow, then its **Humans** tab.

![The workflow's Humans tab: the join code HITL-422WCA with Copy, Copy link, New code and Turn off, a QR code with a Download link, an Invite by email form, and the list of humans with their roles](https://mintcdn.com/hitl/8U4JOCXRGxwTV383/images/editor/humans-tab.png?fit=max\&auto=format\&n=8U4JOCXRGxwTV383\&q=85\&s=d5993172aa736efe0fbd54a45e9103f4)

| Way | How it works |
| - | - |
| **Email** | Type one or more addresses and click **Invite**. Each person gets an email; people without an account create one from it. Add a phone number to reach them by voice call |
| **Join code** | A code such as `HITL-422WCA`. Anyone with a HITL account enters it in the app (or in my.hitl.sh under **Workflows → Join with a code**) and joins as a reviewer |
| **Link** | **Copy link** gives `https://hitl.sh/invites/HITL-422WCA`: on a phone it opens the app, on a computer it opens my.hitl.sh |
| **QR code** | Scan it with the phone's camera or in the app. **Download** saves it as an image to print or share |

**New code** replaces the code (the old one stops working); **Turn off** disables joining by code. People who already joined stay.

From code: [`POST /workflows/:id/invitations`](https://docs.hitl.sh/api-reference/reviewers/invite) and the [join code endpoints](https://docs.hitl.sh/api-reference/reviewers/join-code.md), or the MCP tools `invite_to_workflow` and `create_workflow_join_code`.

## Joining as a reviewer

![The HITL iOS app showing a workflow invitation, Support escalations, 3 of 10 joined, with a Join this workflow button](https://mintcdn.com/hitl/8U4JOCXRGxwTV383/images/mobile/join.png?fit=max\&auto=format\&n=8U4JOCXRGxwTV383\&q=85\&s=8d7ed33b67cd09d9ec2c7d331a134651)

iOS: open the code or link, then Join this workflow

![The Join a workflow dialog in my.hitl.sh with a join code typed in and Cancel and Continue buttons](https://mintcdn.com/hitl/8U4JOCXRGxwTV383/images/app/join-code.png?fit=max\&auto=format\&n=8U4JOCXRGxwTV383\&q=85\&s=ef061d6c09b42fb17f14c11b72076ebc)

my.hitl.sh: Workflows, Join with a code

Workflows you review appear under **Shared with you** in my.hitl.sh and in the app's **Workflows** tab. You can leave a workflow from its page in the app.

## Roles

| Role | Can |
| - | - |
| **Owner** | Everything: build, run, invite, see executions. One per workflow |
| **Admin** | Answer, and help manage the reviewers |
| **Member** | Answer the requests sent to them |

## Plan limits

Your plan sets how many humans you can have (3 on Free and Starter, 5 on Pro). See [Billing](https://docs.hitl.sh/billing.md).


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