Endpoint: /server/admin-users

Returns list of EFT admin users and creates new admin users.

Method & URL

GET https://[server URL]:[port]/admin/v2/server/admin-users

GET Body Sample

Copy
GET https://{{host}}/admin/v2/admin-users HTTP/1.1
Authorization: EFTAdminAuthToken {{AuthToken}}

GET Response Body Sample

Copy
{
"data": [  
{    
"id": "59774c12-870d-5560-a44a-c5b35cf68d4c",    
"type": "adminUser",    
"attributes": {      
"name": "admin"    
}  
},  
{    
"id": "b76a1d7b-c3ad-5ac4-8636-06ce71ba3af3",    
"type": "adminUser",    
"attributes": {      
"name": "Local computer\\Administrators"    
}  
}
],
"links": {   
"self": "admin/v2/admin-users"
}
}

GET POWERSHELL SAMPLE

Copy
#get Server admin users
Write-Output "Get Server admin users"
Write-Output "-----"
$serverAdmins = Invoke-RestMethod -Uri "$baseURL/v2/admin-users" -Method 'GET' -Headers $authHeader
Write-Output $serverAdmins | ConvertTo-Json
foreach ($server in $serverAdmins.data)
{
    Write-Output ("Server $($serverAdmins.data)") 
}

Method & URL

POST https://[server URL]:[port]/admin/v2/server/admin-users

POST Body Sample

Copy
POST https://{{host}}/admin/v2/admin-users HTTP/1.1
Authorization: EFTAdminAuthToken {{AuthToken}}
{
  "data": {
      "attributes": {
      "name": "Test_admin2",
      "password": "test",
      "adminConsolePermissions": {
        "accountPolicy": "server",
        "enableCom": true,
        "enableEditingAndReporting": true,
        "enablePersonalDataAccess": true
      },
      "restPermissions": {
        "enabled": true,
        "restAdminRole": true
      }
    }
  }
}

POST Response Body Sample

Copy
HTTP/1.1 201 Created Date: Tue, 09 Aug 2022 18:18:00 GMT Content-Type: application/vnd.api+json ETag: "BF7E8C0E" 
Content-Length: 394 Cache-Control: no-cache, no-store, must-revalidate Expires: -1 X-Content-Type-Options: 
nosniff X-XSS-Protection: 1; mode=block Content-Security-Policy: default-src 'self' 'unsafe-inline' 
'unsafe-eval' data:; Referrer-Policy: no-referrer
{ "data": 
{ "id": "9693cbcf-d4a9-49ac-aa1c-59efd91a692b", "type": "adminUser", "attributes": { "adminConsolePermissions": { 
"accountPolicy": "Server", "enableCom": true, "enableEditingAndReporting": true, "enablePersonalDataAccess": true }, 
"name": "Test_admin2", "restPermissions": { "enabled": true, "restAdminRole": "server_full_access" } } }, "links": { 
"self": "/admin/v2/admin-users/9693cbcf-d4a9-49ac-aa1c-59efd91a692b" } }

POST PowerShell Sample

Copy
#POST Server Admin user (New User)
Write-Output "POST Server Admin (New Admin user)"
Write-Output "-----"
$update = 
'{
  "data": {
    "id": "1",
    "attributes": {
      "name": "Test_admin",
      "password": "test",
      "adminConsolePermissions": {
        "accountPolicy": "server",
        "enableCom": true,
        "enableEditingAndReporting": true,
        "enablePersonalDataAccess": true
      },
      "restPermissions": {
        "enabled": true,
        "restAdminRole": true
      }
    }
  }
}'
$update = $update | ConvertFrom-Json
$update = $update | ConvertTo-Json -Depth 10
$patchReturn = Invoke-RestMethod -Uri "$baseURL/v2/admin-users" -Method 'POST' -Headers $authHeader -Body $update