skycloak_create_realm_import
Import a Keycloak realm into a cluster from an uploaded archive or existing export. Creates the realm with its users and credentials; a name collision is refused instead of overwriting.
Instructions
Import a Keycloak realm into a cluster from an uploaded archive or an existing realm export. Asynchronous: poll skycloak_get_realm_import. Creates a new realm: preflight refuses a name collision rather than overwriting, so an existing realm of the same name fails with 409. It does import users and their credentials, so 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_create_realm_import"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| confirm | Yes | must be true: the import creates a realm complete with users and credentials | |
| password | No | password that decrypts the archive; required for an encrypted one | |
| cluster_id | Yes | the cluster ID to import into | |
| upload_s3_key | No | s3_key from skycloak_create_realm_import_upload_url, after uploading the archive | |
| source_export_id | No | ID of an existing realm export to import instead of an upload |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| realm | Yes | ||
| status | Yes | ||
| progress | Yes | ||
| cluster_id | Yes | ||
| created_at | No | ||
| source_kind | Yes | ||
| completed_at | No | ||
| error_message | No | ||
| source_version | No | ||
| target_version | No |