Skip to main content
PUT
/
roles
/
{id}
Update a role
import requests

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

payload = { "name": "test-role" }
headers = {"Content-Type": "application/json"}

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

print(response.json())
{
  "id": "9902679c-7f7e-4a66-8c28-b178a07afc46",
  "name": "test-role",
  "createdAt": "2025-10-31T18:12:59Z",
  "updatedAt": "2025-10-31T18:44:34Z",
  "permissions": [
    {
      "methods": [
        "OPTIONS",
        "GET",
        "PUT"
      ],
      "path": "/"
    }
  ],
  "uiPermissions": [
    "string",
    "string"
  ]
}

Path Parameters

id
string
required

The role ID. Use GET /roles to get the list of role IDs.

Body

application/json
name
string
required
id
string
createdAt
string<date-time>
Example:

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

updatedAt
string<date-time>
Example:

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

desc
string
permissions
object[]
uiPermissions
string[]

Response

OK

The response is of type any.