fyi.opensocial.listRecoveryKeys

The rotation keys on the group's did:plc that matter: stewards' recovery keys and this host's own, highest priority first. A recovery key outranks the host's, so its holder can undo what the host does to the identity and move the group without it. Requires group.configure.

Details · query
Kindquery
Authorityopensocial.fyi
Indexed

Query

query · GET

Parameters

query string

group

requiredstring · did

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

Output

application/json

hostHolds

requiredboolean

Whether this host still holds a rotation key, and so can change them.

keys

requiredarray
itemsref
Reference

max

requiredinteger

How many recovery keys a group can have.

Errors

NotController

No description in schema.

#key

object

Properties

addedAt

string · datetime

addedBy

string · did

holder

requiredstring
  • knownValues: host | steward

key

requiredstring

Similar lexicons

semantic match

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

  • Add a steward's recovery key to the group's did:plc, ahead of this host's own key. Only the public did:key is sent; the private half stays with the steward. Requires group.configure.

  • Take a recovery key off the group's did:plc. This host's own key cannot be removed this way. Requires group.configure.