Lexicon Garden

place.wisp.v2.secret.rotate

Rotate a webhook signing secret to a newly generated token, or to a caller-supplied one. The old token stops working immediately. The new token is only returned in this response.

Repository @wisp.place did:plc:7puq73yz2hkvbcpdhnsze2qw not from the namespace authority
Details · procedure
Kindprocedure
Authoritysecret.v2.wisp.place
Indexed
Compare Edit in builder → Fork →

Procedure

procedure · POST

Input

application/json

name

requiredstring · record-key

1–64 character server-managed secret ID. Use ASCII letters, digits, dots, underscores, and hyphens only.

  • maxLength: 64

token

string

Optional caller-supplied signing token: 32–256 printable ASCII characters, no whitespace. Omit it to have the server generate one.

  • minLength: 32
  • maxLength: 256

Output

application/json

name

requiredstring

rotatedAt

requiredstring · datetime

token

requiredstring

The new signing token. Only returned here — store it now.

Errors

AuthenticationRequired

No description in schema.

InvalidRequest

No description in schema.

NotFound

No description in schema.

Similar lexicons

semantic match

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

  • place.wisp.v2.secret.create

    procedure not from the namespace authority

    Create a named webhook signing secret. The server generates a random token unless the caller supplies one; the token is returned once in the response. Reference the secret by name via secretId in place.wisp.v2.wh.

  • place.wisp.v2.secret.list

    query not from the namespace authority

    List webhook signing secrets for the caller DID. Token values are never returned.

  • place.wisp.v2.secret.delete

    procedure not from the namespace authority

    Delete a webhook signing secret by name.