This command updates the settings of an account. It can be executed either directly at the account level or from the parent account.

API request 

Method PUT 

/users/{account_id}

Elements table

Root object element: user_update

Example

Method PUT

https://dk-co.keepit.com/users/psmqd-3nqijs-9qi26x/

Body

<user_update>
     <product>a9y02y-qngj1m-yvh5r8</product>
</user_update>

Response

Code: 200 OK

Response body:

Account updated successfully

PowerShell script

try {
    $username = '<Token username>'
    $password = '<Token password>'

    $subaccountID = '<Subaccount GUID>'
    $productID = '<Product ID>'

    $basicauth = [Convert]::ToBase64String([System.Text.Encoding]::ASCII.GetBytes("${username}:${password}"))
    $headers = @{
        "User-Agent" = "PowerShell-Keepit-API-Agent-1.0"
        "Authorization" = "Basic $basicauth"
        "Content-Type" = "application/xml"
    }

    $url = "https://dk-co.keepit.com/users/$subaccountID/"

    $xmlBody = @"
<user_update>
    <product>$productID</product>
</user_update>
"@

    $response = Invoke-WebRequest -Uri $url -Method Put -Headers $headers -Body $xmlBody -ErrorAction Stop -TimeoutSec 10

    Write-Host $response.Content
}
catch {
    $line = $_.InvocationInfo.ScriptLineNumber
    Write-Host "Cannot query Keepit API due to: $_"
    Write-Host "at line $line"
}

Additional information

• This allows an account to be enabled or disabled, and it allows the product to be changed and the external_id to be changed. To clear the product, supply an empty string for the product.
• When an account is disabled, authentication for that account will fail.
• If the parent element is set, this will move the account to the new parent GUID. Only an administrator or partner token can move an account, and the parent can only be set to an account at or beneath the authenticated account.