---
title: "Run connectivity test"
method: PUT
path: "/system/connect/test"
tags: ["system"]
---

# Run connectivity test

`PUT /system/connect/test`

Runs a connectivity test to verify the host is reachable from the network.

## Response `200`

Connectivity test result.

- TestResult
  - `publicKey` string, required — Ed25519 public key with prefix.
  - `version` string, required — Explorer API version used for the test.
  - `rhp4` RHP4Result[], required — Results for each RHP4 protocol and address tested.
    - `netAddress` string, required — Protocol and address that was tested.
    - `resolvedAddresses` string[], required — IP addresses the hostname resolved to.
    - `connected` boolean, required — Whether a TCP/UDP connection was established.
    - `dialTime` integer — Time to establish the connection in nanoseconds.
    - `handshake` boolean, required — Whether the protocol handshake completed.
    - `handshakeTime` integer — Time to complete the handshake in nanoseconds.
    - `scanned` boolean, required — Whether the host settings were successfully retrieved.
    - `scanTime` integer — Time to retrieve host settings in nanoseconds.
    - `settings` object, nullable — Host settings returned during the scan. Null if the scan failed.
    - `errors` string[], nullable — Errors encountered during the connectivity test.
    - `warnings` string[], nullable — Warnings encountered during the connectivity test.

## Other responses

- `400` — Connectivity test not enabled.

## Changes

> 8 revisions in range; 1 could not be searched.

- **2025-10-09** `9253c6f7b002` — 3 breaking
  - the `rhp4/items/dialTime` response's property type/format changed from `string`/`` to `integer`/`int64` for status `200`
  - the `rhp4/items/handshakeTime` response's property type/format changed from `string`/`` to `integer`/`int64` for status `200`
  - the `rhp4/items/scanTime` response's property type/format changed from `string`/`` to `integer`/`int64` for status `200`
- **2025-10-08** `103993fc0091` — 3 breaking
  - the `rhp4/items/dialTime` response's property type/format changed from `integer`/`int64` to `string`/`` for status `200`
  - the `rhp4/items/handshakeTime` response's property type/format changed from `integer`/`int64` to `string`/`` for status `200`
  - the `rhp4/items/scanTime` response's property type/format changed from `integer`/`int64` to `string`/`` for status `200`

[Change history](https://skmtc.dev/siafoundation/apis/hostd-api/changes/system/connect/test/put.md)

---

[API](https://skmtc.dev/siafoundation/apis/hostd-api.md) · [All operations](https://skmtc.dev/siafoundation/apis/hostd-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/siafoundation/hostd-api/revisions/08ff756929fc/schema)