Sign in
Remote Access

🛡️ Disable Remote Access.

Closes the control channel and disables Remote Access. When the cloud account JWT header is present, the Remote Access credential is also revoked with Cardinal Cloud.<br /><hr /><h3>🛡️ Requires Capabilities: <code>ServerSettings.Update</code></h3>

post/api/v1/connect/disable

Headers

CardinalTolkienstring

Response

enabledboolean required

Whether Remote Access is enabled on this server.

state'disconnected' | 'connecting' | 'connected' | 'auth_failed' | 'not_approved' | 'suspended' required

Live state of the control channel to the Remote Access Server. not_approved means the cloud account is waiting on service access for a Remote Access feature, and suspended means the account is suspended; both retry on their own.

hostnamestring nullable required

The hostname assigned by the Remote Access Server, once registered.

signingKeyFingerprintstring nullable required

Truncated SHA-256 fingerprint of the probe signing key, for support diagnostics.

tokenExpiresAtstring nullable required

Expiry of the stored cloud credential, ISO 8601.

publicPortnumber nullable required

The externally reachable port advertised to the Remote Access Server.

directUrlstring nullable required

The URL clients use to reach this server directly. Null until a hostname is assigned.

relayUrlstring nullable required

The URL clients use to reach this server through the relay.

Changes