# Users

Organization users and location memberships (invites, directory)

## List users (location memberships)

 - [GET /users](https://docs.trueflight.app/tf-docs/users/listusers.md): Returns one row per location membership. Org-wide keys may filter with location_id.
Location-scoped keys only see that location.

## Get user and memberships

 - [GET /users/{userId}](https://docs.trueflight.app/tf-docs/users/getuser.md)

## Invite user to one or more locations

 - [POST /users/invitations](https://docs.trueflight.app/tf-docs/users/createuserinvitation.md): Creates or reuses an auth user, ensures an org profile, creates pending location memberships, and optionally sends invitation email.
role is a custom role name or UUID for this organization.

## Resend invitation email

 - [POST /users/invitations/{membershipId}/resend](https://docs.trueflight.app/tf-docs/users/resenduserinvitation.md): Only allowed when membership status is pending.