{
"lexicon": 1,
"id": "place.wisp.v2.secret.rotate",
"defs": {
"main": {
"type": "procedure",
"description": "Rotate a webhook signing secret, generating a new token. The old token stops working immediately. The new token is only returned in this response.",
"input": {
"encoding": "application/json",
"schema": {
"type": "object",
"required": ["name"],
"properties": {
"name": {
"type": "string",
"format": "record-key",
"maxLength": 64,
"description": "1–64 character server-managed secret ID. Use ASCII letters, digits, dots, underscores, and hyphens only."
}
}
}
},
"output": {
"encoding": "application/json",
"schema": {
"type": "object",
"required": ["name", "token", "rotatedAt"],
"properties": {
"name": { "type": "string" },
"token": {
"type": "string",
"description": "The new signing token. Only returned here — store it now."
},
"rotatedAt": { "type": "string", "format": "datetime" }
}
}
},
"errors": [
{ "name": "AuthenticationRequired" },
{ "name": "InvalidRequest" },
{ "name": "NotFound" }
]
}
}
}