Skip to main content
POST
Rotate a WebSocket secret

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

orgId
string
required

Organization ID

Example:

"org-abc123"

id
string
required

Identifier of the WebSocket secret to rotate

Example:

"rts-3f2b8c1d"

Response

New plaintext secret returned once; the old secret is immediately revoked

id
string
required
Example:

"rts-3f2b…"

label
string
required
Example:

"MacBook ops"

secret
string
required

Plaintext secret — shown ONCE. Copy it now; it is never retrievable again.

Example:

"wss_J8x…"

lastFour
string
required

Last 4 chars (the dashboard masks it as wss_…XXXX).

Example:

"a1B2"

createdAt
string<date-time>
required