Skip to main content
PUT
/
users
/
{id}
Update a user
import requests

url = "https://{FUSION HOST}/api/users/{id}"

payload = {
    "username": "1new-user-test",
    "realmName": "native",
    "timezone": "Pacific Time (US & Canada)",
    "permissions": [{ "methods": ["GET", "PUT"] }]
}
headers = {"Content-Type": "application/json"}

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

print(response.text)
{
  "id": "fe0885f2-8885-4c46-a3ea-8e5d0041c293",
  "username": "1new-user-test",
  "realmName": "native",
  "createdAt": "2025-10-30T21:59:01Z",
  "roleNames": [],
  "timezone": "Pacific Time (US & Canada)",
  "permissions": [
    {
      "methods": [
        "PUT",
        "GET"
      ]
    }
  ]
}

Path Parameters

​
id
string
required

The user ID. Note that this is different than the username. Use GET /users to get the list of user IDs.

Body

application/json
​
password
object
​
passwordHash
string
​
roleNames
string[]

Indicates which roles are dynamically applied to users in the realm.

​
timezone
string
Example:

"Pacific Time (US & Canada)"

​
permissions
object[]
​
roles
string[]

One or more user roles. Use GET /roles to get the list of existing roles.

Response

200 - */*

OK

​
id
string
Example:

"fe0885f2-8885-4c46-a3ea-8e5d0041c293"

​
username
string
Example:

"admin"

​
realmName
string
Example:

"ldap-internal"

​
createdAt
string<date-time>
Example:

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

​
updatedAt
string<date-time>
Example:

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

​
roleNames
string[]

Indicates which roles are dynamically applied to users in the realm.

Example:
["search", "developer"]
​
timezone
string
Example:

"Pacific Time (US & Canada)"

​
permissions
object[]