Request to update an employee role

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/deputy/json-schema/deputy-v2-access-management-update-role-request-schema.json",
  "title": "Request to update an employee role",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/deputy-access-management-role-api-openapi.yml#/components/schemas/v2AccessManagementUpdateRoleRequest",
  "type": "object",
  "properties": {
    "roleId": {
      "type": "integer",
      "format": "int32",
      "title": "Role ID (required)"
    },
    "name": {
      "type": "string",
      "title": "Role name (required, must be unique)"
    },
    "reportsTo": {
      "type": "integer",
      "format": "int32",
      "title": "Reports To role ID (required, 0 for top-level)"
    },
    "alsoReportsTo": {
      "type": "array",
      "items": {
        "type": "integer",
        "format": "int32"
      },
      "title": "Also Reports To role IDs (optional)"
    },
    "require2fa": {
      "type": "boolean",
      "title": "Whether 2FA is required for this role"
    },
    "privileges": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "title": "Privileges to assign to the role"
    }
  }
}