place.wisp.v2.secret.create

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.

Repository @wisp.place did:plc:7puq73yz2hkvbcpdhnsze2qw not from the namespace authority
Details · procedure
Kindprocedure
Authoritysecret.v2.wisp.place
Indexed

Procedure

procedure · POST

Input

application/json

name

requiredstring · record-key

Unique 1–64 character secret ID scoped to the caller DID. 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. Use this to register a secret the receiving system already generated.

  • minLength: 32
  • maxLength: 256

Output

application/json

createdAt

requiredstring · datetime

name

requiredstring

token

requiredstring

The signing token. Only returned at creation time — store it now.

Errors

AuthenticationRequired

No description in schema.

InvalidRequest

No description in schema.

AlreadyExists

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

    procedure not from the namespace authority

    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.

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

  • Create a new webhook for a repository.