technitium 0.4.0

# Admin: Update Node IP Addresses

## Endpoint

`/api/admin/cluster/updateIpAddresses`

## Method

GET

## Description

Allows updating the current Cluster node's IP addresses. This call can be made at both Primary and Secondary nodes.

## Authentication

Required. Token must be provided via the `token` parameter.

## Permissions

Administration: Modify

## Parameters

| Name | Type | Required | Conditional | Description |
|------|------|----------|-------------|-------------|
| `token` | string | Yes | No | The session token generated by the `login` or the `createToken` call. |
| `node` | string | No | No | The node domain name for which the API call is intended. When unspecified, the current node is used. Can only be used when Clustering is initialized. |
| `ipAddresses` | string | Yes | No | A comma-separated list of IP addresses to be updated for the current node. |

## Response Fields

| Field | Type | Description |
|-------|------|-------------|
| `clusterInitialized` | boolean | `true` indicating the cluster is active. |
| `dnsServerDomain` | string | The FQDN of this DNS server. |
| `version` | string | The DNS server software version. |
| `clusterDomain` | string | The cluster domain name. |
| `heartbeatRefreshIntervalSeconds` | integer | Heartbeat refresh interval. |
| `heartbeatRetryIntervalSeconds` | integer | Heartbeat retry interval. |
| `configRefreshIntervalSeconds` | integer | Config refresh interval. |
| `configRetryIntervalSeconds` | integer | Config retry interval. |
| `configLastSynced` | string (datetime) | Timestamp of last config sync. |
| `nodes` | array | List of cluster node objects with updated IP addresses. |
| `nodes[].id` | integer | Unique node ID. |
| `nodes[].name` | string | Node FQDN. |
| `nodes[].url` | string | Node HTTPS API URL. |
| `nodes[].ipAddresses` | array of strings | Node IP addresses (updated for the current node). |
| `nodes[].type` | string | Node type: `Primary` or `Secondary`. |
| `nodes[].state` | string | Node state: `Self`, `Connected`, or `Unreachable`. |
| `nodes[].lastSeen` | string (datetime) | Timestamp of last contact. |

## Conditional Logic Notes

- Unlike most cluster endpoints, this call can be made at both Primary and Secondary nodes.
- When called on a Secondary node, the node will also propagate the IP address change to the Primary.
- The `ipAddresses` parameter replaces all existing IP addresses for the node; it is not additive.

## Edge Cases

- Setting incorrect IP addresses could make the node unreachable to other cluster nodes.
- The IP addresses must be reachable by all other nodes in the cluster.
- This only updates the current node's IP addresses; to update another node's, use the appropriate endpoint on that node.