Skip to main content
POST
/
roles
Create a role
import requests

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

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

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

print(response.json())
{
  "id": "e4ac80c6-8905-4eaf-9670-b541b41f732e",
  "name": "test-role",
  "createdAt": "2025-10-31T18:12:59Z",
  "desc": "For testing only",
  "permissions": [
    {
      "methods": [
        "OPTIONS",
        "GET"
      ],
      "path": "/"
    }
  ],
  "uiPermissions": []
}

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

Created

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[]