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.

Repository @delve.town did:plc:qzqct2rrq4u2gmy5g3mjxske namespace authority
Details · procedure
Kindprocedure
Authoritymembership.delve.town
Indexed

Procedure

procedure · POST

Input

application/json
  • maxLength: 128

revision

integer

The membership revision the caller last saw; the join fails with MembershipChanged if it moved.

Output

application/json

Errors

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 match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • Admits 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.

  • Ask 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.

  • Join a home with an invite token as a member (no approval step).