Rotate a WebSocket secret
Issues a fresh plaintext secret for an existing secret record and immediately invalidates the previous value, terminating any live socket still using it. The new plaintext secret is returned ONCE and is never retrievable again. The caller may only rotate secrets they own. Requires a Nevermined API key. Requires active organization membership. Requires the organization to be on the Enterprise tier.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Organization ID
"org-abc123"
Identifier of the WebSocket secret to rotate
"rts-3f2b8c1d"
Response
New plaintext secret returned once; the old secret is immediately revoked
"rts-3f2b…"
"MacBook ops"
Plaintext secret — shown ONCE. Copy it now; it is never retrievable again.
"wss_J8x…"
Last 4 chars (the dashboard masks it as wss_…XXXX).
"a1B2"
Related topics
Revoke a WebSocket secretGenerate a WebSocket secretList the caller's own WebSocket secretsActivity & EventsRotate a webhook signing secret