Lexicon Garden

fyi.opensocial.removeRecoveryKey

Take a recovery key off the group's did:plc. This host's own key cannot be removed this way. 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.

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

HostKey

No description in schema.

UnknownKey

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

    procedure

    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.

  • fyi.opensocial.listRecoveryKeys

    query

    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.

  • fyi.opensocial.deleteRule

    procedure

    Remove a rule. Requires group.configure.

  • fyi.opensocial.deleteGroup

    procedure

    Delete the group: its account, its repo and its spaces on this host, and the host's own state about it. Irreversible. Requires group.configure, or, for a deactivated group, having held it when the group was switched off. Records members wrote into its spaces live on their own PDSes and are not touched. If no steward holds a recovery key, the group's did:plc is tombstoned too, since nobody could ever use it again; with one, the DID is left for its holders.

  • fyi.opensocial.deleteRole

    procedure

    Remove a role. Requires group.configure. Fails if any membership still holds it.