Lexicon Garden

fyi.opensocial.updateGroupHandle

Give the group a handle on a domain it owns, once that domain names the group by its _atproto DNS record or its /.well-known/atproto-did; or give it back its own address as its handle. Updates the group's did:plc and tells the network. Its address stays reserved for it. Requires group.configure.

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

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.

handle

requiredstring · handle

The new handle: a domain that names the group, or the group's own address.

Output

application/json

handle

requiredstring · handle

Errors

InvalidHandle

No description in schema.

UnsupportedDomain

No description in schema.

HandleNotAvailable

No description in schema.

NotPointing

No description in schema.

NotController

No description in schema.

InvalidOperation

The PLC directory refused the change, as when another was made first: ask again.

Similar lexicons

semantic match

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

  • fyi.opensocial.checkGroupHandle

    query

    Whether a domain is ready to be the group's handle: what its _atproto DNS record, or its /.well-known/atproto-did, names now. Changes nothing. Requires group.configure.