skycloak_update_theme_content
Replaces a theme's archive in place to update its content while preserving its ID, name, and assignments, avoiding the unbranded gap from deleting and re-uploading.
Instructions
Replace an existing theme's archive with a new one, in place. The theme keeps its ID, its name and every realm and application assignment, and the new content deploys immediately, so this is the way to edit a theme: deleting and re-uploading detaches it and leaves the sign-in page unbranded in between. Pass the ZIP or Keycloakify JAR base64-encoded in content_base64. Set confirm=true to proceed: the archive being replaced is not recoverable afterwards. The replacement must still contain every theme type the theme provides today, or the API rejects it; a theme created by a platform migration has pinned content and answers 409. When the workspace has exact_theme_names on (see skycloak_get_theme_settings), this sets restart_required=true on the theme until skycloak_restart_cluster_instances applies it.
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>",
"theme_id": "<theme_id>",
"content_base64": "<content_base64>",
"confirm": "<confirm>"
},
"name": "skycloak_update_theme_content"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| confirm | Yes | must be true to confirm the current archive is overwritten, which cannot be undone | |
| version | No | new version label to record once the content is live, e.g. v2.4; omit to keep the current one | |
| filename | No | archive filename; a .jar name is sent as a Keycloakify JAR, anything else as a ZIP (default theme.zip) | |
| theme_id | Yes | the ID of the theme whose content is replaced | |
| cluster_id | Yes | the cluster ID | |
| content_base64 | Yes | the replacement theme archive (ZIP or Keycloakify JAR) base64-encoded |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| name | Yes | ||
| status | Yes | ||
| version | No | ||
| file_size | Yes | ||
| theme_types | Yes | ||
| restart_required | No |