place.wisp.v2.secret.rotate Documentation (EN)

main procedure

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

Encodingapplication/json

name stringrecord-key Required

A valid record key for AT Protocol repositories.

Output

Encodingapplication/json

name string Required

No description available.

rotatedAt stringdatetime Required

An RFC 3339 formatted timestamp.

token string Required

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

Errors

AuthenticationRequired

NotFound

Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Service Endpoint Base URL for XRPC calls (e.g., https://bsky.social)

Request Body (JSON) Enter valid JSON for the request body

View raw schema

{
  "type": "procedure",
  "input": {
    "schema": {
      "type": "object",
      "required": [
        "name"
      ],
      "properties": {
        "name": {
          "type": "string",
          "format": "record-key"
        }
      }
    },
    "encoding": "application/json"
  },
  "errors": [
    {
      "name": "AuthenticationRequired"
    },
    {
      "name": "NotFound"
    }
  ],
  "output": {
    "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"
        }
      }
    },
    "encoding": "application/json"
  },
  "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."
}