Appendix A — Error Codes
The error_code field is stable across releases. Treat it as the
machine identifier and surface message only to humans.
268 codes, generated from the agent source by agent/scripts/gen_error_codes.py; do not edit by hand.
Authentication & session
| Code | HTTP | Raised by | Description |
|---|---|---|---|
AUTH_2FA_INVALID |
400 / 401 | auth, exceptions, profile |
Invalid 2FA code |
AUTH_2FA_LOCKED |
429 | auth, exceptions |
Too many failed 2FA attempts, temporary lock |
AUTH_CAPTCHA_FAILED |
400 | auth |
reCAPTCHA verification failed (low score or invalid token) |
AUTH_EXPIRED |
401 | auth, exceptions |
Timestamp drift > 300 s, or session cookie expired. |
AUTH_FAILED |
401 / 403 / 404 | api_keys, auth, backups +21 |
Invalid API key, signature, or session cookie. |
AUTH_LOCKED |
429 | auth |
Too many failed sign-in attempts for this identity; retry after the Retry-After seconds. |
AUTH_RATE_LIMITED |
429 | exceptions |
Too many authentication attempts from this address; wait for the Retry-After period. |
AUTH_REQUIRED |
401 | license |
Endpoint requires authentication and none was provided. |
CROSS_ORIGIN_DENIED |
403 | main |
A cookie-authenticated write arrived from an origin that is neither the panel's nor in the trusted origins list. |
API keys
| Code | HTTP | Raised by | Description |
|---|---|---|---|
API_KEY_LIMIT |
403 | exceptions |
The number of API keys allowed on this server has been reached. |
API_KEY_NOT_FOUND |
404 | exceptions |
No API key with this id. |
API_KEY_REVOKED |
403 | exceptions |
The API key was revoked; create a new one. |
HMAC_FORBIDDEN_FOR_CREDENTIAL_MUTATION |
403 | accounts, client_accounts, exceptions +1 |
Credential change refused for this caller: root and sub-account passwords need a session, an account password a session or a full-access key (403) |
SCOPE_DENIED |
403 | audit_logs, exceptions |
The API key's permission scope does not cover this endpoint. |
SCOPE_LOOKUP_FAILED |
500 | audit_logs |
The API key's permission scope could not be read. |
Request validation & framework
| Code | HTTP | Raised by | Description |
|---|---|---|---|
BUNDLE_MISMATCH |
403 | main |
Browser-only: the bundle fingerprint does not match. SDKs are exempt. |
HTTPS_REQUIRED |
403 | system |
The request reached the panel over plain HTTP (directly, or at a proxy that reports X-Forwarded-Proto: http); the API answers over HTTPS only. Send it to https:// on port 443. |
HTTP_405 |
405 | node_apps, python_apps |
The method is not allowed on this route. |
HTTP_<status> |
404 / 405 | main |
Plain HTTP errors from the framework (unknown route, method not allowed) wrapped in the standard envelope; the code carries the status. |
IDEMPOTENCY_KEY_INVALID |
400 | main |
Header value doesn't match ^[A-Za-z0-9_-]{8,64}$. |
IDEMPOTENCY_KEY_REUSED |
409 | main |
Same key replayed by the same credential with a different method, path or body. |
NOT_FOUND |
404 | exceptions, node_apps, profile |
The named resource does not exist. |
PAYLOAD_TOO_LARGE |
413 | main |
The request body exceeds the size limit of this endpoint. |
VALIDATION_ERROR |
400 / 422 | auth, cron, emails +8 |
Pydantic schema rejection. details carries field-level reasons; a body field the endpoint does not define is refused as well (request bodies accept only their defined fields). |
Firewall & security services
| Code | HTTP | Raised by | Description |
|---|---|---|---|
ATTACK_MODE_ACTIVE |
409 | exceptions |
Under-attack mode is already active (409) |
ATTACK_MODE_INACTIVE |
409 | exceptions |
Under-attack mode is not currently active (409) |
BANNED_WORD |
403 | exceptions |
The value contains a word the server's wordlist refuses. |
FAIL2BAN_ERROR |
500 | exceptions |
Fail2Ban service error |
FAIL2BAN_JAIL_NOT_FOUND |
404 | exceptions |
Fail2Ban jail not found |
IP_ADD_FAILED |
500 | system_ip_service |
The address could not be added to the interface. |
IP_DELETE_FAILED |
500 | system_ip_service |
The address could not be removed from the interface. |
IP_NOT_ALLOWED |
403 | exceptions, main |
Source IP is not in the API key's allowlist. |
IP_WHITELISTED |
409 | exceptions |
The address is whitelisted; the block would sit below the allow rule and never match. Remove it from the whitelist first (409). |
IP_WHITELIST_SELF_LOCKOUT |
400 | system |
Admin IP list does not cover the caller (400; force=true overrides) |
RATE_LIMIT |
429 | main, node_apps |
Tier limit exceeded; honour Retry-After. |
RATE_LIMIT_APPLY_FAILED |
500 | exceptions |
The kernel refused the rule's ipset / iptables objects; nothing was recorded (500). |
SELF_LOCKOUT |
422 | validators |
Deny/block covers the caller's own address (422) |
WAF_CONFIG_ERROR |
500 | exceptions, modsecurity_service |
ModSecurity configuration syntax error |
WAF_CUSTOM_RULE_INVALID |
422 | waf_custom_rules |
Custom WAF rule refused before it was kept: a directive, operator or action the panel does not accept, a missing, reserved or taken rule id, the rule engine's parser or a web server's configuration test; details.issues names each with its line and column (422) |
WAF_CUSTOM_RULE_NOT_FOUND |
404 | waf_custom_rules |
Unknown custom WAF rule id (404) |
WAF_MODULE_ERROR |
500 | exceptions |
Webserver ModSecurity module load error |
WAF_NOT_INSTALLED |
503 | exceptions, modsecurity_service |
ModSecurity is not installed |
WAF_RULE_NOT_FOUND |
404 | exceptions, modsecurity_service |
WAF rule ID not found |
WAF_TEST_UNAVAILABLE |
409 | exceptions |
No ModSecurity config test for the running webserver (409) |
WORDLIST_NOT_FOUND |
404 | exceptions |
No wordlist with this name. |
Accounts, plans & resellers
| Code | HTTP | Raised by | Description |
|---|---|---|---|
ACCOUNT_EXISTS |
409 | exceptions |
Username already provisioned. |
ACCOUNT_NOT_FOUND |
404 | auth, exceptions, profile |
Username unknown. |
ACCOUNT_SUSPENDED |
403 | exceptions |
The account is suspended; until it is resumed its cron jobs cannot be changed or run and no domain (addon, subdomain, parked) can be added to it. |
ACCOUNT_TERMINATED |
400 | accounts, auth |
The target account is terminated and cannot be impersonated. |
DISK_LIMIT |
403 | exceptions |
Disk quota exceeded |
DISK_QUOTA_EXCEEDED |
403 | exceptions |
The account's disk quota is full. |
PLAN_EXISTS |
409 | exceptions |
A plan with this name already exists. |
PLAN_IN_USE |
409 | exceptions |
The hosting plan or reseller ACL plan is still assigned to accounts and cannot be deleted; details carries the count. |
PLAN_LIMIT |
403 | exceptions |
Plan limit exceeded |
PLAN_NOT_FOUND |
404 | exceptions |
Hosting plan not found |
RESELLER_LIMIT |
403 | exceptions |
Reseller resource limit exceeded |
RESELLER_NOT_FOUND |
404 | exceptions |
Reseller not found |
Domains, DNS, SSL & PHP
| Code | HTTP | Raised by | Description |
|---|---|---|---|
ADDON_DOMAIN_LIMIT |
403 | exceptions |
Addon domain limit exceeded |
DNS_ERROR |
500 | exceptions |
PowerDNS API failure. |
DNS_RECORD_NOT_FOUND |
404 | exceptions |
No DNS record with this id in the zone. |
DNS_RECORD_PROTECTED |
409 | exceptions |
The zone's SOA record and its last NS record are managed by the server: the SOA cannot be edited or deleted, the last NS cannot be deleted. |
DNS_ZONE_EXISTS |
409 | exceptions |
A zone for this domain already exists. |
DNS_ZONE_NOT_FOUND |
404 | exceptions |
No zone for this domain. |
DOMAIN_EXISTS |
409 | exceptions |
Domain already mounted on this server. |
DOMAIN_NOT_FOUND |
404 | exceptions |
Domain unknown. |
DOMAIN_NOT_OWNED |
403 | emails, exceptions, logs |
The domain is not registered to this account. |
PARKED_DOMAIN_EXISTS |
409 | exceptions |
Parked domain already exists |
PARKED_DOMAIN_LIMIT |
403 | exceptions |
The plan's parked domain limit has been reached. |
PHP_PACKAGE_JOB_IN_PROGRESS |
409 | exceptions |
A PHP version is being installed or removed; one PHP version job runs at a time, and the OS package upgrade and web server plugin work wait until it has finished. |
PHP_VERSION_IN_USE |
409 | exceptions |
The PHP version cannot be removed: it is the default, a domain or account uses it, or the web server configuration names it (details.reason: default, domains, config). |
PHP_VERSION_UNAVAILABLE |
422 | exceptions |
The PHP version cannot be installed here: the operating system has no build of it (PHP 5.6 on the RHEL family) or PHP runs through LiteSpeed (LSAPI). |
REDIRECT_NOT_FOUND |
404 | exceptions |
Redirect not found |
SSL_EMAIL_REQUIRED |
400 | exceptions |
A contact e-mail address is required before a certificate can be requested. |
SSL_ERROR |
500 | exceptions |
Let's Encrypt or custom certificate operation failed. A Let's Encrypt request that was not issued carries the reason in the message and in details.reason (one finding per line: what the certificate authority reported for each name, or certbot's own error line). |
SSL_EXISTS |
409 | exceptions |
The domain already has a certificate. |
SSL_NOT_FOUND |
404 | exceptions |
No certificate for this domain. |
SUBDOMAIN_LIMIT |
403 | exceptions |
Subdomain limit exceeded |
VHOST_CONFIG_ERROR |
500 | exceptions |
Custom VHost configuration error (syntax invalid or apply failed) |
Databases
| Code | HTTP | Raised by | Description |
|---|---|---|---|
DATABASE_EXISTS |
409 | exceptions |
Database name collision. |
DATABASE_LIMIT |
403 | exceptions |
Plan database limit reached. |
DATABASE_NOT_FOUND |
404 | databases, exceptions |
No database with this name on the account. |
DATABASE_SSO_DISABLED |
503 | exceptions |
Single sign-on to the database manager is switched off. |
DATABASE_UPGRADE_IN_PROGRESS |
409 | exceptions |
A MariaDB series upgrade has the databases read-only while it checks the new series; the write is refused until it finishes. |
DATABASE_USER_EXISTS |
409 | exceptions |
A database user with this name already exists. |
DATABASE_USER_NOT_FOUND |
404 | exceptions |
No database user with this name. |
INTERNAL_DB_PROTECTED |
403 | exceptions |
The database belongs to the server and cannot be changed through the API. |
PMA_INSTALL_FAILED |
500 | phpmyadmin_service |
phpMyAdmin could not be installed. |
PMA_NOT_INSTALLED |
500 | databases, phpmyadmin_service |
phpMyAdmin is not installed on this server. |
PMA_SSO_FAILED |
500 | databases |
A phpMyAdmin session could not be opened. |
REMOTE_DB_DENIED |
403 | exceptions |
Remote database access denied |
REMOTE_DB_HOST_EXISTS |
409 | exceptions |
The remote host is already allowed for this account. |
| Code | HTTP | Raised by | Description |
|---|---|---|---|
EMAIL_EXISTS |
409 | exceptions |
Email account already exists. |
EMAIL_FORWARDER_EXISTS |
409 | exceptions |
A forwarder to that destination already exists. |
EMAIL_FORWARDER_NOT_FOUND |
404 | exceptions |
Forwarder not found for this mailbox. |
EMAIL_INACTIVE |
409 | emails, exceptions |
The email account is inactive; activate it first. |
EMAIL_LIMIT |
403 | exceptions |
The plan's email account limit is reached. |
EMAIL_NOT_CONFIGURED |
400 / 500 | auth, profile |
No e-mail address is set for the account or the administrator, so the code cannot be sent. |
EMAIL_NOT_FOUND |
404 | emails, exceptions, spam |
Email account not found for this hosting account. |
EMAIL_SEND_FAILED |
500 | notifications |
The message could not be sent; check the SMTP settings. |
MAIL_QUEUE_MESSAGE_NOT_FOUND |
404 | exceptions |
No message with that id is in the mail queue. |
SMTP_NOT_CONFIGURED |
400 | profile |
SMTP settings must be configured before e-mail two-factor authentication can be used. |
SMTP_PASSWORD_REQUIRED |
400 | notifications |
The SMTP server, port, user or encryption changed while the password field still held the masked stored password: type the password again. |
SMTP_TARGET_FORBIDDEN |
400 | notifications |
SMTP relay host/port refused (non-submission port or metadata address) |
FTP
| Code | HTTP | Raised by | Description |
|---|---|---|---|
FTP_ACCOUNT_EXISTS |
409 | exceptions |
FTP account already exists. |
FTP_ACCOUNT_NOT_FOUND |
404 | exceptions |
No FTP account with this name. |
FTP_LIMIT |
403 | exceptions |
Plan FTP account limit reached. |
FTP_NOT_ORPHAN |
409 | exceptions |
The FTP account belongs to a hosting account and cannot be removed as an orphan. |
Files
| Code | HTTP | Raised by | Description |
|---|---|---|---|
FILE_EXISTS |
409 | exceptions |
A file or folder with this name already exists. |
FILE_NOT_FOUND |
404 | exceptions, node_apps |
File or directory does not exist. |
FILE_TOO_LARGE |
400 / 413 | branding_assets, exceptions, node_apps +2 |
Uploaded file exceeds size limit |
PATH_TRAVERSAL |
403 | exceptions |
.., null byte, or symlink escape detected. |
PROTECTED_PATH |
403 | exceptions |
The path belongs to the system and cannot be changed. |
UNSUPPORTED_ARCHIVE |
422 | exceptions |
The archive format is not supported. |
Cron
| Code | HTTP | Raised by | Description |
|---|---|---|---|
CRON_JOB_EXISTS |
409 | exceptions |
An identical cron job already exists. |
CRON_JOB_NOT_FOUND |
404 | exceptions |
No cron job with this id. |
CRON_RUN_TIMEOUT |
408 | exceptions |
The manual run did not finish within 85 seconds and was stopped; the scheduled runs are not affected. |
Backups
| Code | HTTP | Raised by | Description |
|---|---|---|---|
BACKUP_DECRYPT_FAILED |
409 | exceptions |
The sealed backup archive does not open with this server's encryption secret, or it was altered or cut short; the restore was refused. |
BACKUP_DISABLED |
403 | exceptions |
The backup system is switched off in the server settings; backups, restores and schedules are refused until it is switched on. |
BACKUP_ENCRYPTION_KEY_MISSING |
409 | exceptions |
Archive encryption needs the server's encryption secret, which is not configured on this host; a sealed archive can be neither made nor opened here. |
BACKUP_ERROR |
500 | exceptions |
Backup creation or restore failed. |
BACKUP_FILE_CORRUPT |
409 | exceptions |
The archive on disk no longer matches the checksum recorded when it was made; the restore was refused. |
BACKUP_FILE_MISSING |
410 | exceptions |
The backup is listed but its archive file is gone from disk; it can only be deleted. |
BACKUP_IN_PROGRESS |
409 | exceptions |
A backup, a restore or a scheduled backup is running; an update would cut it with its restart. The message names the work and when it started — install after it finishes. |
BACKUP_NOT_FOUND |
404 | exceptions |
No backup with this id for the account. |
BACKUP_SCHEDULE_LIMIT |
403 | exceptions |
The account's backup schedule limit has been reached. |
BACKUP_SCHEDULE_NOT_FOUND |
404 | exceptions |
No backup schedule with this id. |
BUNNY_AUTH_FAILED |
400 | system |
Bunny.net refused the account API key (400). |
BUNNY_FETCH_FAILED |
502 | system |
The storage zone list could not be fetched from Bunny.net (502). |
GOOGLE_DRIVE_AUTH_FAILED |
400 | system |
Google refused the authorization code exchange, or the state of the sign-in did not match (400). |
GOOGLE_DRIVE_NO_CREDENTIALS |
500 | remote_backup_service |
The Google Drive destination has neither an OAuth refresh token nor a service-account file. |
ONEDRIVE_AUTH_FAILED |
400 | system |
Microsoft refused the authorization code exchange, or the state of the sign-in did not match (400). |
REMOTE_BACKUP_AUTH_FAILED |
500 | remote_backup_service |
The remote destination refused the credentials or returned no access token. |
REMOTE_BACKUP_DOWNLOAD_FAILED |
500 | remote_backup_service |
The provider refused or dropped the download. |
REMOTE_BACKUP_HOST_FORBIDDEN |
422 | exceptions |
The destination host resolves to a private, loopback or metadata address and is refused (422). |
REMOTE_BACKUP_NOT_FOUND |
404 | remote_backup_service |
The file is not on the remote destination. |
REMOTE_BACKUP_UPLOAD_FAILED |
500 | remote_backup_service |
The provider refused or dropped the upload; the local archive is complete. |
REMOTE_DESTINATION_DISABLED |
409 | exceptions |
The remote destination is switched off; enable it or pick another one. |
REMOTE_DESTINATION_EXISTS |
500 | remote_backup_service |
A destination with the same id already exists. |
REMOTE_DESTINATION_IN_USE |
409 | exceptions |
A backup schedule still uses the destination; edit or remove the schedule first (details.schedules). |
REMOTE_DESTINATION_NOT_FOUND |
404 | remote_backup_service |
No remote destination with that id in the caller's store. |
REMOTE_PROVIDER_UNKNOWN |
500 | remote_backup_service |
The stored destination names a provider type the agent does not know. |
YANDEX_DISK_AUTH_FAILED |
400 | system |
Yandex refused the authorization code exchange, or the state of the sign-in did not match (400). |
Plugins & LiteSpeed
| Code | HTTP | Raised by | Description |
|---|---|---|---|
PLUGIN_ACTIVATION_ERROR |
500 | plugins |
Activation pipeline failed (vhost migrate, package install, …). |
PLUGIN_DEACTIVATION_ERROR |
500 | plugins |
Deactivation rollback failed. |
PLUGIN_DISABLED |
503 | node_apps, python_apps |
The plugin this feature belongs to is not active; enable it under Plugins. |
PLUGIN_LIST_ERROR |
500 | plugins |
The plugin list could not be read. |
PLUGIN_NOT_FOUND |
404 | plugins |
Unknown plugin id. |
PLUGIN_TASK_IN_PROGRESS |
409 | exceptions, plugins |
A web server plugin is being activated, deactivated or updated (or this plugin's background activation has not finished); one such job runs at a time, and the OS package upgrade and PHP version jobs wait until it has finished. |
PLUGIN_TASK_NOT_FOUND |
404 | plugins |
Async task id unknown or expired. |
PLUGIN_UPDATE_ERROR |
500 | plugins |
The plugin's state could not be changed. |
PLUGIN_UPDATE_NOT_SUPPORTED |
400 | plugins |
Plugin does not implement update(). |
PLUGIN_VALIDATION_ERROR |
400 | plugins |
Bad mode / serial / state for the requested operation. |
Python & Node.js apps
| Code | HTTP | Raised by | Description |
|---|---|---|---|
NODE_APP_EXISTS |
409 | exceptions |
A Node.js application with this name already exists on the account. |
NODE_APP_LIMIT |
403 | exceptions |
The plan's Node.js application limit has been reached. |
NODE_APP_NOT_FOUND |
404 | exceptions |
No Node.js application with this name. |
NODE_APP_START_ERROR |
500 | exceptions |
The application process could not be started. |
NODE_NPM_ERROR |
500 | exceptions |
The npm command failed. |
NODE_SCRIPT_DENIED |
403 | exceptions |
The package script is not allowed to run. |
NODE_VERSION_NOT_FOUND |
400 | exceptions |
The requested Node.js version is not installed. |
NODE_WORKER_LIMIT |
403 | exceptions |
The plan's worker process limit has been reached. |
PYTHON_APP_EXISTS |
409 | exceptions |
Python app with this name already exists for account |
PYTHON_APP_LIMIT |
403 | exceptions |
Maximum Python apps reached for this account |
PYTHON_APP_NOT_FOUND |
404 | exceptions |
Python app not found |
PYTHON_APP_START_ERROR |
500 | exceptions |
Application server failed to start |
PYTHON_MANAGE_CMD_DENIED |
403 | exceptions |
manage.py command not in allowed list |
PYTHON_PIP_ERROR |
500 | exceptions |
pip install/uninstall failed |
PYTHON_VENV_ERROR |
500 | exceptions |
Virtualenv creation/management failed |
PYTHON_VERSION_NOT_FOUND |
400 | exceptions |
Requested Python version not installed on server |
PYTHON_WORKER_LIMIT |
403 | exceptions |
Worker count exceeds plan limit |
Updates & migration
| Code | HTTP | Raised by | Description |
|---|---|---|---|
MIGRATION_API_ERROR |
502 | exceptions |
The source panel's API returned an error. |
MIGRATION_BACKUP_INVALID |
400 | exceptions |
The backup archive fetched from the source WHost server during a migration could not be read. |
MIGRATION_CONNECTION_FAILED |
400 | exceptions |
The source server could not be reached with the given details. |
MIGRATION_CREDENTIALS_EXPIRED |
400 | migration |
The stored SSH credentials have expired; scan the source server again. |
MIGRATION_INVALID_STATE |
400 | exceptions |
The job is not in a state that allows this action. |
MIGRATION_JOB_NOT_FOUND |
404 | exceptions |
No migration job with this id. |
MIGRATION_PANEL_UNKNOWN |
400 | exceptions |
Cannot detect cPanel/DA on source server |
MIGRATION_SCAN_FAILED |
500 | exceptions |
The source server could not be scanned. |
MIGRATION_SECURITY_ERROR |
400 | exceptions |
The source server's host key or the transferred data failed a security check. |
MIGRATION_SSH_FAILED |
400 | exceptions |
SSH connection to source server failed |
MIGRATION_UPLOAD_RESTORE_UNAVAILABLE |
409 | exceptions |
Restoring from an uploaded backup file is not offered; migrate the accounts over SSH (POST /migration/scan, then POST /migration/start). |
OS_UPGRADE_IN_PROGRESS |
409 | exceptions |
An OS package upgrade is running: one started from OS Packages, or the guarded OS update run (its run lock is held). Package work started from the panel (OS packages, a PHP version install or removal, a web server plugin's activation, deactivation or update) waits until it has finished. |
UPDATE_ALREADY_LATEST |
400 | exceptions |
Returned in response body when no upgrade is available. |
UPDATE_CHECK_REQUIRED |
400 | exceptions |
Returned when an install is requested before any update check has run in this agent process; call /system/update/check first. |
UPDATE_DOWNGRADE_REJECTED |
400 | exceptions |
The requested version is older than the installed one. |
UPDATE_INSTALL_FAILED |
500 | exceptions |
WHost update pipeline aborted; rollback completed. |
UPDATE_INVALID_VERSION |
400 | exceptions |
The version string is not valid. |
UPDATE_IN_PROGRESS |
409 | exceptions |
An install is already running: a second install is refused, and so are a backup and a restore until the install's restart. |
License
| Code | HTTP | Raised by | Description |
|---|---|---|---|
LICENSE_ACCOUNT_LIMIT |
403 | exceptions |
The license's hosting account limit is reached: no new account can be created until the license is upgraded or an account is removed; existing accounts are not affected (403). Operator routes carry used, limit and plan_type in details; reseller and client routes get a message without the figures. |
LICENSE_ACTIVATION_FAILED |
400 | exceptions |
License key rejected by the license service. |
LICENSE_ADDON_REQUIRED |
403 | whitelabel |
The write needs a licence addon the current licence does not carry (whitelabel); the stored values are left as they are (403) |
LICENSE_NOT_ACTIVATED |
403 | exceptions, license_gate |
License key has never been activated. |
LICENSE_SERVER_UNREACHABLE |
503 | exceptions |
License server unreachable (grace period may apply) |
LICENSE_SUSPENDED |
403 | exceptions, license_check, license_gate |
License is suspended, expired or invalid. |
LICENSE_VERIFY_FAILED |
400 | exceptions |
License verification failed (explicit FAILED from server) |
SERVER_UNREACHABLE |
— | wlicense_client |
The licence server could not be reached. |
Webhooks
| Code | HTTP | Raised by | Description |
|---|---|---|---|
DELIVERY_NOT_FOUND |
404 | webhooks |
Unknown webhook delivery id (404) |
DELIVERY_PAYLOAD_MISSING |
400 | webhooks |
Delivery cannot be retried: original payload no longer stored (400) |
WEBHOOK_DISABLED |
409 | webhooks |
The webhook endpoint is disabled or muted; enable it before a test event or a retry can be addressed at it (409) |
WEBHOOK_NOT_FOUND |
404 | webhooks |
Unknown webhook endpoint id (404) |
WEBHOOK_VALIDATION |
400 | webhooks |
Webhook endpoint refused: private/loopback URL, unknown event, weak secret (16-128 printable ASCII), malformed muted_until (400) |
Notifications & profile
| Code | HTTP | Raised by | Description |
|---|---|---|---|
NOTIFICATION_NOT_FOUND |
404 | firewall, notifications |
Notification not found |
NOTIFICATION_SEND_FAILED |
500 | profile |
Notification could not be sent (SMTP error etc.) |
PROFILE_PASSWORD_MISMATCH |
400 | profile |
Current password is wrong |
Background tasks
| Code | HTTP | Raised by | Description |
|---|---|---|---|
TASK_NOT_FOUND |
404 | node_apps, python_apps |
Deploy task id unknown to this account (python-apps / node-apps) |
TOO_MANY_TASKS |
429 | node_apps, python_apps |
Concurrent deploy limit reached for the account (429) |
System & services
| Code | HTTP | Raised by | Description |
|---|---|---|---|
APACHE_CONFIG_TEST_FAILED |
500 | exceptions |
Apache refused the new configuration; the change was rolled back. |
APACHE_NOT_RUNNING |
503 | exceptions |
Apache is not running. |
APACHE_STATUS_ENABLE_FAILED |
500 | system |
mod_status could not be enabled. |
APACHE_STATUS_ERROR |
500 | system |
The Apache status page could not be read. |
APACHE_STATUS_NOT_AVAILABLE |
503 | exceptions |
Apache's status page is not available on this server. |
CODE_EXPIRED |
400 | profile |
The verification code has expired; request a new one. |
CONFIRM_REQUIRED |
400 | emails |
The action needs its explicit confirmation parameter. |
DEPENDENCY_MISSING |
500 | profile |
A library the feature needs is not installed on the server. |
FEATURE_DISABLED |
409 | exceptions |
The feature is switched off in the agent's configuration; the request is refused until it is enabled (409) |
FEATURE_UNAVAILABLE |
403 | firewall |
The feature is handled at the server level and is not available per account. |
FEEDBACK_ATTACHMENT_REJECTED |
422 | exceptions |
A screenshot or attached file was refused: type outside the list, content that does not match its type, an image canvas over 24 megapixels, or more than 5 files; details.reason names it (422). |
FEEDBACK_DISABLED |
403 | exceptions |
Product feedback is not open for this server: the publisher's channel is off, the licence is not active or in grace, or the whitelabel brand is on; details.reason names it (403). |
FEEDBACK_FAILED |
502 | exceptions |
The publisher refused the report for a reason this agent does not know; the reason is in details.reason (502). |
FEEDBACK_LINK_REJECTED |
422 | exceptions |
A link was refused: not an absolute http(s) address, credentials inside it, longer than 500 characters, or more than 5 links (422). |
FEEDBACK_NOT_RECOGNISED |
403 | exceptions |
The publisher does not match this server's licence key and address to a live service, so it takes no report from it (403). |
FEEDBACK_REJECTED |
422 | exceptions |
The report itself was refused: a type other than bug, idea or question, or a description outside 20-5000 characters (422). |
FEEDBACK_SPAM |
422 | exceptions |
The publisher's content check refused the report text (422). |
FEEDBACK_TOO_LARGE |
413 | exceptions |
The screenshot is over 3 MB, a file over 10 MB, or the files over 16 MB together (413). |
FEEDBACK_TOO_MANY |
429 | exceptions |
The publisher's report allowance for this licence is spent for now (5 an hour, 20 a day); try again later (429). |
FEEDBACK_UNAVAILABLE |
503 | exceptions |
The publisher's feedback receiver could not be reached or is not taking reports right now (503). |
FORBIDDEN |
403 | dns, php, spam +1 |
The resource belongs to another account. |
HOSTNAME_CERT_DNS_MISSING |
422 | exceptions |
The server name does not resolve, so Let's Encrypt cannot reach it; point its A record at this server first. |
HOSTNAME_CERT_INSTALL_FAILED |
500 | exceptions |
The issued server name certificate failed a configuration test or reload; the previous certificate is back in place. |
HOSTNAME_CERT_IN_PROGRESS |
409 | exceptions |
A certificate request for the server name is already running. |
HOSTNAME_CERT_ISSUE_FAILED |
502 | exceptions |
Let's Encrypt refused or could not complete the server name certificate request; the message and details.certbot carry the reason (what the certificate authority reported for each name, or certbot's own error line); nothing was changed. |
HOSTNAME_CERT_NOT_ISSUABLE |
422 | exceptions |
The server name cannot carry a public certificate (details.reason: no_hostname, address, not_fqdn, reserved_name). |
HOSTNAME_UPDATE_FAILED |
500 | system |
The server's hostname could not be changed. |
IMAGE_DIMENSIONS_TOO_LARGE |
400 | branding_assets |
The uploaded image is larger than 25 megapixels; it is refused from its header, before any pixel is decoded. |
INTERNAL_ERROR |
500 | system |
The operation failed on the server. |
INVALID_FILE_TYPE |
400 | branding_assets, profile, python_apps |
Uploaded file has invalid MIME type or malformed SVG |
INVALID_HOSTNAME |
422 | system |
Hostname is not a valid FQDN (422) |
INVALID_IMAGE |
400 | branding_assets |
The uploaded file does not decode as the image type its content declares (truncated or damaged file). |
INVALID_IP |
422 | system |
Server address is not a routable unicast IPv4 (422) |
INVALID_JSON |
400 | main |
The request body is not valid JSON. |
INVALID_LOGO_TYPE |
400 | whitelabel |
Invalid logo type parameter (valid: light, dark, favicon, favicon_dark) |
INVALID_OPERATION |
400 | profile |
The action does not fit the current state (for example a setup that was not started). |
INVALID_QUEUE_ID |
400 | emails |
The mail queue id is not valid. |
INVALID_REQUEST |
400 | node_apps, python_apps |
The request is missing a required part. |
INVALID_TOKEN |
400 | auth |
Password-reset token is invalid, expired or already used. |
INVALID_VIDEO |
400 | branding_assets |
The uploaded sign-in page video is not a readable MP4: its box structure is broken or truncated, it has no video track, or its frame is outside 1-4096 px (400). |
IONCUBE_NOT_INSTALLED |
503 | exceptions |
IonCube Loader not installed for PHP version |
LIMIT_REACHED |
403 | domains |
The plan's limit for this resource has been reached. |
LOGIN_VIDEO_NOT_FOUND |
404 | whitelabel |
The sign-in page has no uploaded video or cover, so there is nothing to remove (404). |
LOGIN_VIDEO_REQUIRED |
400 | whitelabel |
A cover image was sent for a sign-in page that has no uploaded video; send the video first or together with the cover (400). |
LOGO_NOT_FOUND |
404 | whitelabel |
No whitelabel logo of that type is set, so there is nothing to remove (404) |
MISSING_RECIPIENT |
400 | notifications |
No recipient e-mail address is configured. |
NGINX_CONFIG_FAILED |
500 | system |
nginx refused the new configuration; the change was rolled back. |
NO_FILE |
400 | whitelabel |
No file provided in upload request |
PERMISSION_DENIED |
403 | auth, exceptions |
The caller is authenticated but lacks the required permission. |
PORT_IN_USE |
422 | system |
SSH port is held by the panel or another listener (422) |
REBOOT_SCHEDULE_FAILED |
500 | system |
The reboot could not be scheduled. |
REMOTE_STORE_ENCRYPTION_FAILED |
500 | remote_backup_service |
The destination's credentials could not be encrypted, so nothing was saved. |
REMOTE_STORE_UNREADABLE |
500 | exceptions |
The remote destination store on disk is not valid JSON; nothing was written over it. Repair or restore the file. |
SERVICE_ERROR |
500 | exceptions |
systemd service management failure. |
SETUP_NOT_INITIATED |
400 | profile |
Two-factor setup has not been started; call the setup endpoint first. |
SYSTEM_ERROR |
500 | exceptions, main, profile |
Internal server error (catch-all; check agent log). |
TWO_FACTOR_ALREADY_ENABLED |
409 | profile |
Two-factor authentication is already enabled. |
TWO_FACTOR_NOT_ENABLED |
400 | profile |
Two-factor authentication is not enabled. |
UNSUPPORTED_MEDIA_TYPE |
415 | branding_assets, profile, whitelabel |
The uploaded file is not one of the types this upload accepts, judged from its content rather than the declared type: an avatar or a whitelabel image that is not PNG, JPEG or WebP (SVG too for logos), or a sign-in page video that is not an MP4 or whose video track is not H.264 (415). |
UPLOAD_TOO_LARGE |
413 | python_apps |
The upload exceeds the size limit; use the server path mode instead. |
WEBMAIL_NOT_INSTALLED |
503 | emails, exceptions |
Roundcube webmail is not installed on this server. |
WEBMAIL_SSO_NOT_CONFIGURED |
503 | exceptions |
The webmail single sign-on bridge (Dovecot master user) is not configured. |
WEBSERVER_NOT_APACHE |
422 | exceptions |
The action needs Apache, which is not the web server of this installation. |
Still Need Help?
Our support team is here around the clock for anything you can't find above.