Devices

Connect or reconnect over SSH

Returns 202, not readiness. With no pinned host key, this only probes: poll, compare the fingerprint to a trusted source, then send a fresh idempotency_key and host_key_fingerprint to install. Never blindly trust a probe. Later reconnects reuse retained credentials and valid Device identity. A repeated key replays the original operation without launching again. Poll GET with a deadline; after interruption use a fresh key explicitly. Authorization is checked at admission; revoking the initiating API key does not cancel accepted setup or revoke its Device. Non-systemd hosts need manual Reconnect after restart. REST only.

<sub>Scope: ssh:write</sub>

post/v3/organizations/{orgId}/ssh-connections/{connectionId}/connect

Request

  • Base URL: https://api.reasonmachines.com
  • URL: https://api.reasonmachines.com/v3/organizations/{orgId}/ssh-connections/{connectionId}/connect
  • Auth: HTTP bearer

Request body

host_key_fingerprintstring
idempotency_keystring required

Persist one non-secret key per logical request. Retry the identical body/key for up to 24 hours. Expired or deleted request keys return 409; reconnect intentionally with a fresh key.

Response

Accepted operation or replay; poll the connection.

replayedboolean required
operation_idstring uuid required

Changes

No recorded changes to this operation across all 1 revision of this API.