skycloak_restart_cluster_instances
Restarts a Keycloak cluster's instances to apply pending theme changes, such as replaced content under an exact theme name. Requires confirm=true because live traffic is disrupted.
Instructions
Restart a cluster's Keycloak instances, disrupting live traffic on it. Use this after skycloak_update_theme_settings turns exact_theme_names on: a theme whose content was replaced under its exact name only serves the new content once Keycloak restarts (see restart_required on skycloak_get_theme / skycloak_list_themes). Applies immediately unless the workspace latches disruptive changes to the maintenance window, in which case the result reports deferred=true and, when known, next_window (RFC3339). Returns a conflict when the cluster cannot restart right now: already busy with a restart or other update, not in an available state, or the operator has no environment variable slot left. Set confirm=true to proceed.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"cluster_id": "<cluster_id>",
"confirm": "<confirm>"
},
"name": "skycloak_restart_cluster_instances"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| confirm | Yes | must be true to confirm the restart, which disrupts live traffic on the cluster | |
| cluster_id | Yes | the cluster ID |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| impact | Yes | ||
| deferred | Yes | ||
| next_window | No |