Skip to main content
PUT
/
realm-configs
/
{id}
Update a realm
import requests

url = "https://{FUSION HOST}/api/realm-configs/{id}"

payload = {
    "realmType": "ldap",
    "name": "dev-ldap3",
    "config": {
        "autoCreateUsers": True,
        "host": "my.fusionhost.com",
        "ssl": True,
        "port": 10636,
        "login": { "bindDnTemplate": "uid={},ou=users,dc=security,dc=example,dc=com" }
    }
}
headers = {"Content-Type": "application/json"}

response = requests.put(url, json=payload, headers=headers)

print(response.text)
{
  "realmType": "ldap",
  "id": "df32cba0-5540-4d73-b769-9f4eaca45e11",
  "name": "dev-ldap3",
  "enabled": false,
  "createdAt": "2025-10-31T17:06:33Z",
  "updatedAt": "2025-10-31T17:35:08Z",
  "config": {
    "autoCreateUsers": true,
    "host": "my.fusionhost.com",
    "ssl": true,
    "port": 10636,
    "ephemeralUsers": false,
    "login": {
      "bindDnTemplate": "uid={},ou=users,dc=security,dc=example,dc=com"
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://doc.lucidworks.com/llms.txt

Use this file to discover all available pages before exploring further.

Path Parameters

​
id
string
required

The realm ID. Note that this is not always the same as the realm name. Use GET /realm-configs/default to get the list of realm names with their IDs.

Body

application/json
​
name
string
required

The name of the realm. This name will appear on the login screen of the UI, and will appear in user records to identify the realm they belong to.

​
realmType
string
required

Use the /realm-configs endpoint to get the list of valid realm types.

Example:

"native"

​
id
string
​
enabled
boolean

If true, the realm is available for users to use with system authentication.

​
createdAt
string<date-time>
Example:

"2025-09-23T17:48:07Z"

​
updatedAt
string<date-time>
Example:

"2025-10-31T12:28:04Z"

Response

OK