town.delve.membership.join
Join the town, or rejoin after withdrawing. An account hosted on the town's own PDS needs no code; any other account presents an invite code: either a town invite or a code a member took from Settings on the town's PDS, which the join then spends. Requires auth.
Details · procedure
| Kind | procedure |
|---|---|
| Authority | membership.delve.town |
| Indexed |
Procedure
procedure · POSTInput
application/jsoninviteCode
stringmaxLength: 128
revision
integerThe membership revision the caller last saw; the join fails with MembershipChanged if it moved.
Output
application/jsonErrors
InvalidInvite
No valid invite for this account: missing, expired, spent, disabled, or bound to another account.
MembershipSuspended
No description in schema.
MembershipChanged
No description in schema.
MembershipDisabled
This AppView does not admit accounts by membership.
Similar lexicons
semantic matchLexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.
-
social.colibri.beta.community.join
procedureAdmits the requesting user to a community. Joining is an AppView procedure rather than a record the user writes, because admission is what makes the community's spaces readable to them.
-
fyi.opensocial.requestJoin
procedureAsk to join a group, optionally redeeming an invitation. An invite the group has sent the caller, neither taken back nor past its expiresAt, admits them at once, whatever the group's join policy, with the group's default roles; one named that is not such an invite is refused. Unnamed, a waiting invite is redeemed all the same. No role required; authenticated as the requester.
-
The requesting account's standing in the town. Requires auth.
-
An account's standing in the town. Active members are indexed and served; withdrawn members keep what they posted but add nothing new; a suspended account is neither.
-
ai.newnal.illi.home.join
procedureJoin a home with an invite token as a member (no approval step).