Skip to main content
Replace the caller's account settings.
A full replacement, not a patch: fields you omit revert to their defaults.

Authorizations

Authorization
string
header
required

Short-lived (≤ 1h) bearer token from POST /auth/token.

Expiry is EXACT — there is no grace period past expires_in, on REST or on the streaming transport. Refresh on a margin.

A structurally valid, unexpired token is still refused when it has been revoked (401), when the operator has invalidated the tokens the account was holding (401), or when the account is suspended (403). Suspension also blocks issuing a new one, so re-authenticating does not clear it.

Body

application/json

Per-account preferences (GET/PUT /account/settings), persisted with the account. Omitted fields default on PUT.

cancel_on_disconnect_default
boolean
default:false

Account-wide default for /v1/stream cancel-on-disconnect. A login frame's explicit cancel_on_disconnect value overrides it.

Response

The updated settings.

Per-account preferences (GET/PUT /account/settings), persisted with the account. Omitted fields default on PUT.

cancel_on_disconnect_default
boolean
default:false

Account-wide default for /v1/stream cancel-on-disconnect. A login frame's explicit cancel_on_disconnect value overrides it.