PATCH
/api/im/remote/bindings/{id}/candidates
Republish daemon connection candidates
Daemon republishes its current connection candidates (e.g. LAN IP rotated,
relay region failed over). Candidates are validated against Offer v2's
directTcp / relay discriminated union and persisted on im_desktop_bindings.candidates.
Mobile clients pick the lowest-latency candidate; E2EE is applied on top regardless.
No code sample available for this language
Parameters
| Field | Type | Req | Default | Description |
|---|---|---|---|---|
| id | string | Y | — | Binding UUID |
Request Body
| Field | Type | Req | Default | Description |
|---|---|---|---|---|
| candidates | any[] | Y | — | |
| └ type | string (directTcp | relay) | Y | — | Channel kind. |
| └ host | string | N | — | Required when `type=directTcp`. Hostname or IP (1–253 chars). |
| └ port | integer | N | — | Required when `type=directTcp`. TCP port. |
| └ endpoint | string | N | — | Required when `type=relay`. WSS relay URL (e.g. `wss://relay-us-west.prismer.cloud`). |
| └ priority | integer | N | — | Optional client hint (lower = preferred). |
| └ metadata | object | N | — | Optional free-form metadata attached by the daemon. |
Response Example
{
"ok": true
}Try it out
Path Parameters
→ /api/im/remote/bindings/{id}/candidates
Sign in to use your API key
Request Body
Response
Click Execute to test