A group a person found by query is in, and how: through is the group’s own
id when they are directly in it, else the nested group they come in through.
A group query found by its name. A signed in admin also sees its admins’
emails, how many people are directly in it, and its paid balance, credit and
debt in dollars; everyone else gets none of those.
A join code. Admins only. People join with it, and admins of other groups put
their group inside this one with it. max_uses caps how many it lets in;
without it, any number can join until it expires. It expires at expires, in
the future and at most a year out, or in seven days without it.
Invite an email to a group. Admins only. Nobody joins until they accept the
invite with its token (accept_invite), whether or not the email already has
a Fauna account, and the answer is the same either way. Fauna emails the
invite unless notify is false, so an app can send its own email carrying
the token. Resolves to the token.
Invite group child inside group id; the child’s admins accept with the
token (accept_nest). Admins of id only. Nests at once when you administer
both. Unless notify is false, the child’s admins hear about it in their
Fauna inbox. Nesting is at most 5 groups deep and never makes a loop.
Join a group with a join code. With group, a group you administer goes
inside it instead, and you are in it through that group. already_member
says you (or group) were in it already.
Leave a group you are directly in. The last admin can’t while anyone else is
in it, directly or through a nested group: make someone else an admin, or
delete the group. When nobody else is in it, leaving deletes it.
Make a person who is directly in the group an admin. Admins only. Someone in
it only through a nested group is invited directly first. They need room under
their own fauna/groups:N, the most groups they may administer.
People matching a partial email or name, best first, each with every group
they are in and how; only people in at least one group come back. And groups
whose name matches either text, best first: only groups you are in, unless a
signed in admin asks. An admin finds every group, with its admins and
balances, and an admin’s empty search lists the first 20 groups by name.
Delete a group with its chats, files, calendar, rooms, webhooks and
partnerships. It leaves every group it was in; the groups inside it stay. Its
direct admins may, and so may anyone holding fauna/groups:delete:global.
Ask to put group id inside group parent; the parent’s admins approve with
the token (accept_nest). Admins of id only. Nests at once when you
administer both. Unless notify is false, the parent’s admins hear about it
in their Fauna inbox.