Home / Servers / Linode API / post_rebuild_node_balancer_config

Rebuild a config

An MCP tool from the Linode API server, hosted on mcp.hjlabs.in.

Rebuild a config Rebuilds a NodeBalancer config and its nodes that you have permission to modify. Use this operation to update a NodeBalancer's config and nodes with a single request. > 🚧 > > You can configure UDP… [POST /v4/nodebalancers/{nodeBalancerId}/configs/{configId}/rebuild]

Name on the gateway: linode_api__post_rebuild_node_balancer_config · may change things.

Parameters

NameTypeDescription
nodeBalancerId requiredintegerThe ID of the NodeBalancer.
configId requiredintegerThe ID of the Config to access.
algorithmroundrobin | leastconn | ring_hashThe algorithm this UDP NodeBalancer uses to route traffic to backends.
checknone | connection | http | http_bodyThe type of check to perform against backends to ensure they are serving…
check_attemptsintegerHow many times to attempt a check before considering a backend to be down.
check_bodystringThis value must be present in the response body of the check in order for it…
check_intervalintegerHow often, in seconds, to check that backends are up and serving requests.…
check_passiveboolean__Read-only__ Must be false for UDP.
check_pathstringThe URL path to check on each backend. If the backend does not respond to this…
check_timeoutintegerHow long, in seconds, to wait for a check attempt before considering it…
cipher_suitestring__Read-only__ Not applicable for UDP configs.
idinteger__Read-only__ This config's unique ID.
nodebalancer_idinteger__Read-only__ The ID for the NodeBalancer this config belongs to.
nodes requiredarrayThe NodeBalancer nodes that serve this config. Some considerations for Nodes…
nodes_statusobject__Read-only__ Describes the health of the backends for this port. This data…
portintegerThis is the port the NodeBalancer listens on for this configuration. Port…
protocoludpThe protocol the port is configured to serve, udp in this case. Review our…
proxy_protocolstring__Read-only__ Must be none for UDP.
ssl_certstring__Read-only__ Not applicable for UDP configs.
ssl_commonnamestring__Read-only__ Not applicable for UPD configs.
ssl_fingerprintstring__Read-only__ Not applicable for UDP configs.
ssl_keystring__Read-only__ Not applicable for UDP configs.
stickinessnone | session | source_ipControls how session stickiness is handled on this port. - If set to none…
udp_check_portintegerUDP NodeBalancers use TCP and HTTP active health checks to ensure back-end…
udp_session_timeoutinteger__Read-only__ The maximum duration in seconds, a UDP session can be idle…

How to call it

Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:

call_tool arguments
{
  "name": "linode_api__post_rebuild_node_balancer_config",
  "arguments": {
    "nodeBalancerId": 0,
    "configId": 0,
    "nodes": []
  }
}

Or connect the Linode API server directly, which lists 439 tools including this one:

Run in your terminal
claude mcp add --transport http hj-linode-api https://mcp.hjlabs.in/mcp/linode-api \
  --header "Authorization: Bearer YOUR_API_KEY"

Try asking

Use the rebuild a config tool with nodeBalancerId set to ….

More from Linode API