social.grain.unspecced.createGroup

Start a group on Grain's group host. The host creates the group with the viewer as its founder and hands Grain its own session on it (fyi.opensocial.provisionGroup); Grain then gives the group its pool and its Grain profile. The viewer never leaves Grain.

Repository @grain.social did:plc:e7rftrdyz5e2rw4y6ocszew2 not from the namespace authority
Details · procedure
Kindprocedure
Authorityunspecced.grain.social
Indexed

Procedure

procedure · POST

Input

application/json
  • maxLength: 3000
  • maxGraphemes: 300

displayName

requiredstring
  • maxLength: 640
  • maxGraphemes: 64

name

requiredstring

The first label of the group's handle, 3 to 18 characters; the host supplies its domain.

  • minLength: 3
  • maxLength: 18

Output

application/json

did

requiredstring · did

handle

requiredstring · handle

Similar lexicons

semantic match

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

  • Host-level: create a new group on this host. Authenticated as the founder (service auth from their PDS). The founder and any listed stewards become its first admins. Mints the group DID, creates the meta and members spaces, writes the bootstrap records and, for a discoverable group, a declaration. Modality spaces are left to the apps that use them (createSpace).

  • create a group

  • social.grain.unspecced.getGroupHost

    query not from the namespace authority

    The group host this Grain creates groups on, and the domain a new group's handle ends in. Absent when this Grain creates none.

  • Host-level: an app creates a group for a person and gets its own OAuth session on it. Authenticated twice: the person asking, by service auth from their PDS (they become the founder), and the app, by OAuth client authentication in the body (a client assertion for a confidential client) with a DPoP proof in the `DPoP` header, exactly as at the token endpoint. The app must be one this host provisions for. Returns the group and a token response bound to the proof's key, issued to the app's client i

  • Creates a group convo, specifying the members to be added to it. Unlike getConvoForMembers, this isn't idempotent. It will create new groups even if the membership is identical to pre-existing groups. Will create 'request' membership for all members, except the owner who is 'accepted'.