fyi.opensocial.addRecoveryKey

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.

Details · procedure
Kindprocedure
Authorityopensocial.fyi
Indexed

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.

key

requiredstring · did

A did:key (secp256k1 or P-256). Only the public key: the host never sees the private half.

Output

application/json

Errors

InvalidKey

No description in schema.

AlreadyAdded

No description in schema.

TooManyKeys

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.

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

  • 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.