Every error code the HyperView API can return, with its message. Search this page for the code you have.
Codes appear in API responses as error_code, alongside a human-readable detail.
Quick reference
Code | Usually means | Go to |
| The target system is not reachable | |
| The API key lacks a permission | |
| A capability needs approval, or a protected setting change needs a confirmation code | |
| Wrong account UUID or key secret | |
| Session UUID is wrong, or it already closed | |
| Too many calls. Back off and retry | |
| Billing state is blocking the call | |
| Support links work once |
Authentication and API keys
Code | Message | HTTP |
| API key is disabled | |
| API key has expired | |
| An API key with this name already exists | 409 |
| API key not found | 404 |
| Email or password incorrect | 401 |
| Invalid API key credentials | |
| Current password is incorrect | |
| Password does not meet requirements: 10+ length, mixed case, 1+ special char. | 422 |
| Password reset link is invalid or expired | |
| Confirmation code is invalid or expired | 403 |
| Invalid or expired tunnel token | 401 |
| Two-factor code invalid | |
| Verification token is invalid or expired | |
| Invalid or expired viewer session token | 401 |
| This request relaxes more than one protected setting. Step-up codes are bound to a single purpose — relax one setting per request. | 400 |
| Not authenticated: missing or expired token | 401 |
| This account uses social login. Please sign in with your social provider or reset your password to set one. | |
| New password must be different from the current password | |
| Password must be at least 10 characters | |
| reCAPTCHA verification failed | 403 |
| reCAPTCHA token is required | 400 |
| MFA is managed via PUT /account/security | 400 |
| This change requires confirmation. Request a code from /auth/step-up and resubmit with it. | |
| Too many incorrect password attempts — try again later | 429 |
Accounts, users and access
Code | Message | HTTP |
| Access denied: banned | 403 |
| Account is disabled | |
| Account is inactive | |
| Account not found | 404 |
| Account subscription is inactive | |
| User/email already exists | 409 |
| New email must be different from the current sign-in email | |
| User account is inactive | |
| Invalid account | |
| Invitation code is invalid or has expired | |
| Invitation not found | 404 |
| Permission denied | 403 |
| You cannot edit your own account | |
| Too many email change requests — try again later | |
| User is not active | 400 |
| User not found | 404 |
| Email address has not been verified |
Systems, shares and sessions
Code | Message | HTTP |
| File not found | 404 |
| Folder not found | |
| Installation key is not active | 422 |
| Installation key not found | 404 |
| Invalid path | 400 |
| Product version not found | |
| Server not found | |
| Server is offline | |
| Session not found | 404 |
| Share is not active | 403 |
| Share not found or invalid credentials | |
| Version is not allowed for this product. | |
| Version does not belong to the required product. |
Remote support links
Code | Message | HTTP |
| No DesktopAgent version is available for this platform | 503 |
| DesktopAgent link code has already been used | 409 |
| DesktopAgent link has expired | |
| DesktopAgent link not found | 404 |
| DesktopAgent link has been revoked |
Billing and plans
Code | Message | HTTP |
| Account already has an active subscription. Use upgrade instead. | |
| Account billing restricted | |
| Selected plan is not valid | |
| Stripe payload is invalid | |
| Stripe signature is invalid | |
| Target plan must have a higher base price than the current plan | |
| Target plan must have a lower base price than the current plan | |
| No active Stripe subscription found | 400 |
| No pending downgrade to cancel | |
| Account has no Stripe customer record | 400 |
| A downgrade is already scheduled. Cancel it before scheduling a new one. | 409 |
| Failed to create Stripe checkout session | 502 |
| Failed to create Stripe billing portal session | 502 |
| Subscription is already scheduled for cancellation | 409 |
| Your subscription has expired. Please select a plan to continue. | |
| Trial plans are only available for new accounts |
Venues
Code | Message | HTTP |
| Venue is already private | 409 |
| Venue is already public | |
| Venue does not have a valid issued certificate | 422 |
| Venue health check failed | 422 |
| Invalid log level. Valid levels: TRACE, DEBUG, INFO, WARN, ERROR, FATAL | 400 |
| public_ip must be a valid IPv4 address | |
| Invalid venue status transition | 409 |
| target_version must be a non-empty string | 422 |
| Failed to retrieve logs from venue | 502 |
| Failed to change venue log level | 502 |
| name cannot be empty | |
| Venue is not active | |
| Venue must be in DECOMMISSIONED state before it can be deleted | 409 |
| Venue must be DISABLED before a self-update can be triggered. Disable the venue first. | |
| Venue not found | 404 |
| Venue is not in UNINSTALLED status | 409 |
| Venue does not have an API token configured | 422 |
| Venue does not have an assigned FQDN | |
| Cannot configure DNS without a public IP address | |
| A venue with a private IP address cannot be promoted to public | |
| A promotion request is already pending for this venue | |
| Registration token has expired | 410 |
| Registration token not found or venue not in UNINSTALLED status | 404 |
| SSL is not enabled (VENUE_USE_SSL is False) | |
| A self-update is already in progress for this venue. | |
| Only a superuser can promote a venue to public |
Requests and limits
Code | Message | HTTP |
| Invalid query spec | 400 |
| Rate limit exceeded | 429 |
Why a row action is greyed out
Actions on the Systems screen state their own reason rather than failing when you try them. System is offline beside Connect, Other modes, Inspect, Get logs, Transfer files or Send command means the system has not sent a recent heartbeat, so anything needing a live connection is unavailable.
What stays available is what the console can do without the system: Edit, View Details, Assign to folder, Get link, Set log level, Force retest, Reboot, Restart service and Upgrade HyperView. Check the Last Heartbeat column first. The grey dot and a stale heartbeat are the same message in two places.