curl --location 'https://your-cloud-id.threataware.com/public-api/v1/settings/usermanagement/roles' \
  --header 'Accept: application/json' \
  --header 'X-ThreatAware-ApiKey: your-api-key-here'

import requests

API_KEY = "your-api-key-here"
CLOUD_ID = "sandbox"
BASE_URL = f"https://{CLOUD_ID}.threataware.com/public-api/v1"

headers = {
    "Accept": "application/json",
    "X-ThreatAware-ApiKey": API_KEY
}

response = requests.get(
    f"{BASE_URL}/settings/usermanagement/roles",
    headers=headers
)

roles = response.json()
print(f"Retrieved {len(roles['data'])} roles")

# Example: Find custom (non-default) roles
custom_roles = [r for r in roles['data'] if not r.get('default', False)]
print(f"Custom roles: {len(custom_roles)}")

const axios = require('axios');

const API_KEY = 'your-api-key-here';
const CLOUD_ID = 'sandbox';
const BASE_URL = `https://${CLOUD_ID}.threataware.com/public-api/v1`;

axios.get(`${BASE_URL}/settings/usermanagement/roles`, {
  headers: {
    'Accept': 'application/json',
    'X-ThreatAware-ApiKey': API_KEY
  }
})
  .then(response => {
    console.log(`Retrieved ${response.data.data.length} roles`);

    // Example: List role names
    response.data.data.forEach(role => {
      console.log(`- ${role.name} (${role.users.length} users)`);
    });
  });

$ApiKey = "your-api-key-here"
$CloudId = "sandbox"
$BaseUrl = "https://$CloudId.threataware.com/public-api/v1"

$Headers = @{
    "Accept" = "application/json"
    "X-ThreatAware-ApiKey" = $ApiKey
}

$Response = Invoke-RestMethod `
    -Uri "$BaseUrl/settings/usermanagement/roles" `
    -Headers $Headers `
    -Method Get

Write-Host "Retrieved $($Response.data.Count) roles"

# Example: Show role summary
$Response.data | Select-Object name, @{Name="Users";Expression={$_.users.Count}} | Format-Table

{
  "offset": 0,
  "limit": 1,
  "total": 10,
  "data": [
    {
      "id": "superAdmin",
      "name": "Super Admin",
      "description": "Grants the users the highest level of privilege in the platform.",
      "permissions": {
        "deviceVisibility": "All",
        "userVisibility": "All",
        "integrations": "Manage",
        "alertNotes": "Manage",
        "deviceNotes": "Manage",
        "userNotes": "Manage",
        "globalTags": "Manage",
        "apiKeys": "Manage",
        "miscellaneous": "Manage",
        "reports": "Export",
        "scheduledReports": "Manage",
        "previousReports": "Download",
        "browserExtensionAccess": "Login",
        "vitals": "Manage",
        "workflowAutomation": "Manage",
        "vitalsAlerts": "Action",
        "users": "Manage",
        "roles": "Manage",
        "teams": "Manage",
        "ssoSetup": "Manage"
      },
      "default": true,
      "users": [
        {
          "username": "brandon.taylor@company.com",
          "name": "Brandon",
          "surname": "Taylor"
        },
        {
          "username": "gavin.watkins@company.com",
          "name": "Gavin",
          "surname": "Watkins"
        },
        {
          "username": "julian.edwards@company.com",
          "name": "Julian",
          "surname": "Edwards"
        }
      ]
    }
  ],
  "success": true,
  "statusCode": 200,
  "message": "Successfully retrieved roles."
}