Skip to navigation

Errors and response messages

Check codes, not messages

The developer can customize many display messages in app settings. They cannot change machine-readable codes or make a denied request successful. Use result.ok or the HTTP response’s verified success field to check the outcome.

HTTP statusMeaningWhat your app should do
400Invalid requestCheck the documented fields
401Invalid session, credentials or request proofRead the code; request a new login when appropriate
403Access denied by identity, app policy or planShow the server message and stop the denied action
404Record, value, channel or release not foundCheck the name and application
413Body too largeKeep V3 request JSON within 16 KB
415Wrong content typeSend application/json
429Rate limitedRespect Retry-After; avoid retry loops
503A required service/check is unavailableReport a connection problem; do not extend access

Common V3 codes

CodeMeaning
INVALID_REQUESTMissing or invalid request fields
INVALID_PROOFMissing, expired or invalid installation signature
REQUEST_TIME_INVALIDRequest timestamp is outside the accepted window
REQUEST_REPLAYEDThis request nonce was already used
INVALID_CREDENTIALSUsername or password is incorrect
LICENSE_NOT_FOUND, DEVICE_NOT_FOUNDThe license key or device is not registered in this app
USER_BANNED, LICENSE_BANNED, MOTHERBOARD_BANNED, PROCESSOR_BANNEDThat user, license or device is banned
USER_SUSPENDED, LICENSE_PAUSED, MOTHERBOARD_PAUSED, PROCESSOR_PAUSEDThat user, license or device is paused
USER_EXPIRED, LICENSE_EXPIRED, MOTHERBOARD_EXPIRED, PROCESSOR_EXPIREDThat user, license or device has expired
DEVICE_NOT_ALLOWEDThe license or user is locked to a different system ID
DEVICE_LIMIT_REACHEDAll device slots are in use
ACCESS_REVOKEDAccess or its binding is no longer valid
SESSION_EXPIREDSession or access deadline has ended
COUNTRY_BLOCKEDConnection country is blocked
LOCATION_UNAVAILABLERequired IP country could not be resolved
VPN_BLOCKEDVPN/proxy policy rejects the connection
IP_BLOCKED, SID_BLOCKEDThe IP address or system ID is on the app’s blocklist
IP_NOT_WHITELISTED, SID_NOT_WHITELISTEDThe app uses an allowlist and this connection is not on it
UPDATE_REQUIREDThis app version is no longer allowed; the response includes update details
INVALID_HASHThis build’s hash is not approved
APP_DISABLEDThe application is paused by its developer
VPN_CHECK_UNAVAILABLERequired reputation lookup did not complete
OFFLINE_DISABLEDApp has not enabled an offline window
CURRENT_PASSWORD_INVALIDCurrent app password is incorrect
APP_VALUE_NOT_FOUNDCloud variable does not exist in this app
RATE_LIMITEDToo many requests
SIGNING_UNAVAILABLEServer signing is unavailable

Each code above matches an entry on the dashboard’s Responses page, where you can reword its message. This is a common-code list, not every application-specific response. Each endpoint lists its response status codes. Include requestId when asking support about a request; omit credentials and bearer tokens.

Connection failures

A local timeout cannot fetch a customized server message. SDK connection errors are separate from an explicit ban or expiry. Keep signed access only until its allowed deadline. Never close the host application automatically.