Lexicon Garden

social.colibri.beta.community.join

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.

Repository @colibri.social did:plc:mprdjqjluoswa7awzggaggj3 namespace authority
Details · procedure
Kindprocedure
Authoritycommunity.beta.colibri.social
Indexed
Compare Edit in builder → Fork →

Procedure

procedure · POST

Input

application/json

community

requiredstring · did

The community to join.

invitation

string

An invitation code.

Output

application/json

member

ref

The new member view. Present only when status is joined.

Reference

status

requiredstring

The result of the join attempt.

  • knownValues: joined | pending

Errors

AuthRequired

The request is missing, malformed, or unverifiable service auth.

CommunityNotFound

No community exists with that DID.

InvitationNotFound

No invitation exists with that code.

AlreadyMember

The requesting user already holds a member record in this community.

Banned

The requesting user is banned from this community.

CredentialsUnavailable

The AppView's stored credentials for this community are missing or unusable.

Similar lexicons

semantic match

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

  • social.colibri.beta.community.approveApplication

    procedure

    Approves a pending application, admitting the subject as a member.

  • social.colibri.community.approveMembership

    procedure not from the namespace authority

    Approves a pending membership application, minting the member record.

  • fyi.opensocial.requestJoin

    procedure

    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.

  • town.delve.membership.join

    procedure not from the namespace authority

    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.

  • social.colibri.beta.community.adopt

    procedure

    Adopts an existing account as a community: this AppView takes custody of its credentials, creates the four community spaces on whichever PDS already hosts it, and seeds the same starter layout social.colibri.beta.community.create does. The account keeps its own DID, handle and PDS, and the caller becomes its owner. Use this instead of community.create to bring your own DID.