fyi.opensocial.requestJoin

Ask to join, or redeem an invite. No role required; authenticated as the requester.

Details · procedure
Kindprocedure
Authorityopensocial.fyi
Indexed

Showing version bafyreidqnd7jbttk7m4nwh2i5zi57uiqg72e66zrtefji26f6v4irrl3py. Show the latest

Procedure

procedure · POST

Input

application/json

group

requiredstring · did

The group DID. Every method is served by the group's host and authorized against that group's roles.

invite

string · at-uri

message

string

Output

application/json

status

requiredstring
  • knownValues: admitted | pending

Errors

InviteRequired

No description in schema.

AlreadyMember

No description in schema.

Similar lexicons

semantic match

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

  • social.grain.unspecced.joinGroup

    procedure not from the namespace authority

    Ask a group's group host to admit the viewer: Grain mints service auth for the host from the viewer's PDS and calls fyi.opensocial.requestJoin. Admitted immediately when the group is open; queued for its moderators when it takes requests.

  • The caller's own pending request to join, if they have one. Requires no action: listJoinRequests is the moderator's queue and needs `admit`, which leaves a requester unable to see the request they themselves made. Returns nothing once a request has been decided, so a denial is not disclosed.

  • Approve a join request, giving the requester their roles. Requires admit. denyJoinRequest declines one.

  • Deny a pending join request. Requires admit. The requester sees it as no request at all, and may ask again.

  • Sends a request to join a group (via join link) to the group owner. Action taken by the prospective group member.