Error response format

Error messages are returned in the following format:

{"error":{"msg":"Error message","code":"Error code"}}

For uAPI (Bearer) validation errors, the response body may also include a numeric num field — the specific reason number when code is VALIDATION_ERROR:

{"error":{"msg":"…","code":"VALIDATION_ERROR","num":2}}

Error code list

INVALID_API_KEY
Invalid API key

The API key was not found or is incorrect. The provided API key does not exist in the system. This usually means the key was mistyped, deleted, or a non-existent value is being used.

API_KEY_INACTIVE
API key is inactive

The API key exists but is disabled. The key was found in the system but is inactive and cannot be used to execute requests.

NOT_SUPPORTED_METHOD
Method not supported

You are requesting a URL that does not support the HTTP method used (GET, POST, DELETE, or PUT).

API_ACCESS_DENY
The site administrator disabled API for this module

To fix this error, open the module settings in the site Control Panel (/admin) and enable “Enable uAPI for module”.

REQUESTS_LIMIT
Hourly request limit exceeded

Your token is temporarily blocked: the hourly request limit was reached. See uAPI limits for details.

MISSING_REQUIRED_PARAMETER
A required parameter is missing

The request does not include all required parameters. The list for each method is given in the uAPI documentation.

VALIDATION_ERROR
Data validation error (uAPI, Bearer)

The request was rejected because data does not match module rules. The response includes a num field with the specific reason number (see the response schema in Swagger for the corresponding method).

Pages module (POST /pages, PUT /pages): num: 2 — when owntmpl=1, a non-empty custom template body (tmpl) was sent, but the markup is missing the required $POWERED_BY$ placeholder. See the tmpl field description on the Pages module documentation page.

Possible errors with legacy GUID API authorization

INVALID_CONSUMER_KEY
Invalid Consumer Key

You are using an invalid Consumer Key. Check it on the uAPI panel page.

INVALID_SIGNATURE
Invalid signature

Signature generation failed. Possible causes: incorrect Token secret; wrong parameter sorting when building the signature; missing urlencode or base64 step.

UNKNOWN_TOKEN
Token not registered in uAPI

You are using a token that does not exist. To create a token, go to the uAPI panel.

USED_NONCE
Nonce already used

The nonce value you sent was already used. nonce must be unique for each request.

ERROR_AUTH_1
Cannot process request: uID user not found or uID authorization service temporarily unavailable

Possible causes: you are using a uID user token that was deleted, or the uID.me authorization service is temporarily unavailable.

INVALID_VERIFICATION_CODE
Invalid verification code

Invalid verification code. The code is issued after you confirm app access to your data in the application. The issue is often caused by copying the code incorrectly from the browser address bar.

DUPLICATED_OAUTH_PARAMETER
Duplicate OAuth parameter

In the signed request, oauth_version (or another OAuth parameter) appears more than once. Each OAuth parameter must appear only once in the request.

INVALID_TOKEN
Invalid token

An invalid token is being used. Check it on the uAPI panel page.

If you believe the error is incorrect, contact us via the Feedback form or in the uAPI Telegram community.

Please include in your message:

  • all request parameters;
  • the signed request (signature);
  • a description of the action that triggers the error.

This will help us investigate faster and provide an accurate answer.