{
"lexicon": 1,
"id": "place.wisp.v2.secret.create",
"defs": {
"main": {
"type": "procedure",
"description": "Create a named webhook signing secret. The server generates a short random token returned once in the response. Reference the secret by name via secretId in place.wisp.v2.wh.",
"input": {
"encoding": "application/json",
"schema": {
"type": "object",
"required": ["name"],
"properties": {
"name": {
"type": "string",
"format": "record-key",
"maxLength": 64,
"description": "Unique 1–64 character secret ID scoped to the caller DID. Use ASCII letters, digits, dots, underscores, and hyphens only."
}
}
}
},
"output": {
"encoding": "application/json",
"schema": {
"type": "object",
"required": ["name", "token", "createdAt"],
"properties": {
"name": { "type": "string" },
"token": {
"type": "string",
"description": "The signing token. Only returned at creation time — store it now."
},
"createdAt": { "type": "string", "format": "datetime" }
}
}
},
"errors": [
{ "name": "AuthenticationRequired" },
{ "name": "InvalidRequest" },
{ "name": "AlreadyExists" }
]
}
}
}