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

# Invitations overview

> Invite barbers to a shop location and accept or revoke invite links

Use the Invitations API when a shop brings a barber onto a location: create the
invite from the location list, let the barber accept the code, or revoke a link
that should stop working.

## What you do first

1. [List location invitations](/api-reference/invitations/list-location-invitations)
   for the shop location you manage.
2. Hand the invitee [Get an invitation](/api-reference/invitations/get-an-invitation)
   by code so they can see what they are joining.
3. [Accept an invitation](/api-reference/invitations/accept-an-invitation) once
   the barber is signed in and ready to join.
4. [Revoke an invitation](/api-reference/invitations/revoke-an-invitation) when
   the link should die before accept.

## States that matter

| State       | What it means for the next call           |
| ----------- | ----------------------------------------- |
| Outstanding | Code still works for get/accept           |
| Accepted    | Barbership is linked; do not accept again |
| Revoked     | Code stops working                        |

## When a call fails

Failures come back as problem documents. Open the `type` link for the cause,
the fix, and whether retrying is safe. Common ones include an unknown code and
an invite that was already consumed or revoked.

## Related paths

* Shop and business setup live under [Businesses](/api-reference/Businesses/overview)
  and [Shops](/api-reference/Shops/overview).
* The barber profile after join lives under [Barbers](/api-reference/Barbers/overview).