update_account()

Update an account.

All API functions Accounts

Signature

update_account(array $parameters): mixed

Parameters

Pass these parameters as KasRequestParams. Every request also requires kas_login, kas_auth_type, and kas_auth_data, as shown in SOAP with PHP.

Name Description Requirement
account_login The account to update Required
account_kas_password The KAS password Optional
max_account Maximum number of subaccounts the account may create Optional
max_domain Maximum number of domains Optional
max_subdomain Maximum number of subdomains Optional
max_webspace Maximum storage space in MB Optional
max_mail_account Maximum number of mailboxes Optional
max_mail_forward Maximum number of forwards Optional
max_mailinglist Maximum number of mailing lists Optional
max_database Maximum number of MySQL databases Optional
max_ftpuser Maximum number of additional FTP users Optional
max_sambauser Maximum number of network drives Optional
max_cronjobs Maximum number of cron jobs Optional
max_wbk Maximum number of website builders Optional
inst_htaccess May use directory protection Optional
inst_fpse May use the FrontPage Server Extensions Optional
kas_access_forbidden Block access: N|Y|forbidden Optional
show_password Show the notice about displaying passwords Optional
inst_software May use the software installation Optional
logging Access log setting: voll (full), kurz (short), ohneip (without IP addresses), or keine (none) Optional
logage Logs are deleted after this number of days: 1-999 Optional Default: 190
statistic Language of the generated statistics (=/usage), 0 disables them: 0|de|en Optional Default: 0
dns_settings May use the DNS settings Optional
account_comment The account comment Optional
account_contact_mail The contact email address Optional
account_2fa 2FA mode: Y|N|inherited (optional; Y cannot be enabled here, switching to N or inherited requires account_kas_password) Optional

PHP example

<?php

// $sessionToken is returned by KasAuth, see SOAP with PHP.
$parameters = [
    'account_login' => 'w0123456',
    'account_kas_password' => 'my_password',
    'max_account' => '0',
    'max_domain' => '7',
    'max_subdomain' => '0',
    'max_webspace' => '150',
    'max_mail_account' => '9',
    'max_mail_forward' => '6',
    'max_mailinglist' => '0',
    'max_database' => '1',
    'max_ftpuser' => '3',
    'inst_htaccess' => 'Y',
    'inst_fpse' => 'N',
    'inst_software' => 'N',
    'kas_access_forbidden' => 'N',
    'logging' => 'keine',
    'account_comment' => 'comment',
    'max_cronjobs' => '3',
];

try {
    $client = new SoapClient('https://kasapi.kasserver.com/soap/wsdl/KasApi.wsdl');
    $response = $client->KasApi(json_encode([
        'kas_login' => 'w0123456',
        'kas_auth_type' => 'session',
        'kas_auth_data' => $sessionToken,
        'kas_action' => 'update_account',
        'KasRequestParams' => $parameters,
    ]));
    print_r($response);
} catch (SoapFault $fault) {
    echo 'Error: ' . $fault->faultstring;
}
Open interactive example

Responses and error codes

  • TRUE the action was carried out
  • missing_parameter a required parameter is missing
  • in_progress the KAS object is currently being processed
  • account_comment_syntax_incorrect
  • account_contact_mail_syntax_incorrect
  • account_kas_password_syntax_incorrect
  • account_2fa_syntax_incorrect
  • account_2fa_cannot_be_enabled_here
  • account_2fa_change_requires_new_password
  • account_login_not_found
  • couldnt_get_kas_ressources
  • couldnt_get_subaccount_ressources
  • dns_settings_not_allowed
  • dns_settings_syntax_incorrect
  • inst_fpse_not_allowed
  • inst_fpse_syntax_incorrect
  • inst_htaccess_not_allowed
  • inst_htaccess_syntax_incorrect
  • inst_software_not_allowed
  • inst_software_syntax_incorrect
  • kas_access_forbidden_syntax_incorrect
  • logging_syntax_incorrect
  • max_account_for_subaccount_gt_change_value
  • max_account_reached
  • max_account_syntax_incorrect
  • max_cron_for_subaccount_gt_change_value
  • max_cron_reached
  • max_cron_syntax_incorrect
  • max_database_for_subaccount_gt_change_value
  • max_database_reached
  • max_database_syntax_incorrect
  • max_domain_for_subaccount_gt_change_value
  • max_domain_reached
  • max_domain_syntax_incorrect
  • max_ftpuser_for_subaccount_gt_change_value
  • max_ftpuser_reached
  • max_ftpuser_syntax_incorrect
  • max_mail_account_for_subaccount_gt_change_value
  • max_mail_account_reached
  • max_mail_account_syntax_incorrect
  • max_mail_forward_for_subaccount_gt_change_value
  • max_mail_forward_reached
  • max_mail_forward_syntax_incorrect
  • max_mailinglist_for_subaccount_gt_change_value
  • max_mailinglist_reached
  • max_mailinglist_syntax_incorrect
  • max_sambauser_for_subaccount_gt_change_value
  • max_sambauser_reached
  • max_sambauser_syntax_incorrect
  • max_subdomain_for_subaccount_gt_change_value
  • max_subdomain_reached
  • max_subdomain_syntax_incorrect
  • max_webspace_for_subaccount_gt_change_value
  • max_webspace_reached
  • max_webspace_syntax_incorrect