v32

OpenAPI 3.0.3AGPL-3.0-onlyraw.githubusercontent.com2026-08-0178220333.8 KB
settings

POST /settings/relay-probe

Probes a candidate relay URL for reachability. An optional one-time access token is used only for this probe and is never persisted. A probe that fails to reach the relay is a NORMAL categorized outcome returned 200 (mirrors the Tauri command contract) — only a missing relay-diagnostic adapter (server misconfiguration) becomes a 500 ApiError.

post/settings/relay-probe

Request body

urlstring required

Candidate relay URL to probe. Not persisted; the probe is repeatable.

Response

Relay probe outcome (reachable or a categorized failure)

tsinteger required

Server time when the response was built (unix epoch milliseconds).