Errors, formats, and limits
  • 04 Aug 2022
  • 1 Minute to read
  • Dark
  • PDF

Errors, formats, and limits

  • Dark
  • PDF

Article Summary

HTTP Status Errors

Sometimes requests to the API are not successful. Every time, the API returns an HTTP Status Code that indicates the nature of the failure, with a response body in JSON format containing additional information.

CodeMeaningHow to interpret
200SuccessThe request has succeeded.
400Bad RequestRequest has missing arguments or is malformed.
401UnauthorizedCheck your authorization credentials.
403ForbiddenRequest is authenticated but has insufficient permissions.
404Not FoundWrong URL or parameters.
422Unprocessable EntityMay be: wrong validation, wrong parameter, out of range, wrong input.
500Internal Server ErrorThe server encountered an unexpected condition that prevented it from fulfilling the request. Most likely, you don't have enough permissions.

API Limitations

Rate Limiting

500 API calls per minute for POST request. Among the most popular requests you may reach the limit with are:

  • persistentStorage
  • dns/{tenantIdentifier}
  • dns/records/{tenantIdentifier}
  • tenants/store
  • templates/addtemplate
  • vmlist/create
  • kubernetes/cluster
  • {tenantIdentifier}/loadBalancer
  • cluster/database
  • {tenantIdentifier}/firewall

Device Storage Adding

ramvalueMin: 1; Max: 12
cpuvalueMin: 1; Max: 128


For date parameters (such as startDate and endDate ones), we use the ISO8601 format:
YYYY-MM-DD. Example: 2022-02-21.

Was this article helpful?