Lexicon Garden

fyi.opensocial.getGroup

Get a detailed view of a group: its profile and rules, and — for a viewer who may read the members space — how many are in it (listMembers names them), its roles, spaces and their read gates, plus the join queue for a viewer holding `admit`. Without auth, only the group's did and handle; with it, the viewer's standing and what their roles let them read. Every gate is the decision a space credential is minted on.

Repository @lexicons.opensocial.fyi did:plc:2gqnilpksz2e7faj3bwvo6qc namespace authority
Details · query
Kindquery
Authorityopensocial.fyi
Indexed
Compare Edit in builder → Fork →

Query

query · GET

Parameters

query string

group

requiredstring · did

The group DID.

Output

application/json

bindings

array
itemsref
Reference

joinRequests

array

Pending requests, newest first. Present only for a viewer holding `admit`.

itemsref
Reference

roles

array
itemsref
Reference

spaces

array
itemsref
Reference

Errors

GroupNotFound

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.

  • fyi.opensocial.getJoinRequest

    query

    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.

  • fyi.opensocial.defs

    Contents of an access record.

  • fyi.opensocial.listMembers

    query

    A group's members, each with their roles, a page at a time in the order of their DIDs, for a caller who may read its members space. With `q`, only those whose handle or DID holds it.

  • social.grain.unspecced.getGroup

    query not from the namespace authority

    A group: a group DID that has declared itself and shows up in Grain as an author whose pool is other people's galleries.

  • fyi.opensocial.listGroups

    query

    Host-level: the groups hosted here, with their profiles. v1 discovery; a real index would come from declarations on the public network.