Error Codes and Responses

HTTP Statuses

The Fusioo API attempts to return appropriate HTTP status codes for every request.

Code	Message	Description
200	OK	Returned when the request was completed successfully.
400	Bad Request	The request was invalid or cannot be otherwise served. An accompanying error message will explain further.
401	Unauthorized	Authentication credentials were missing or incorrect. This can also happen if the user has revoked access to your application.
404	Not Found	The URI requested is invalid or the resource requested, does not exists. Also returned when the requested format is not supported by the requested method.
429	Too Many Requests	Returned when a request cannot be served due to the API’s rate limit having been exhausted.
500	Internal Server Error	Something is broken. Please contact support@fusioo.com so that the Fusioo dev team can investigate.
503	Service Unavailable	Fusioo is down or being upgraded. Please try again later.
504	Gateway timeout	The Fusioo servers are up, but the request could not be serviced due to some failure from Fusioo's end. Please try again later.

Error Messages

When the Fusioo API returns error messages, it does so in JSON format. For example, an error might look like this:


{
  "code": 10002,
  "message": "The requested resource was not found",
  "data": {}
}

Error Codes

In addition to descriptive error text, error messages contain codes. While the text for an error message may change, the codes will stay the same. The following table describes the codes you might encounter while working with the Fusioo API:

Code	Message	Description
10000	Success	The operation was completed successfully.
10001	Internal Server Error	Something is broken. Please contact support@fusioo.com so that the Fusioo dev team can investigate.
10002	The requested resource was not found	The requested URIis invalid or does not exist. This also happens when the incorrect HTTP method is used, for example using `GET` instead of `POST`.
10003	Unauthorized access	This can happen if the Access Token is expired, invalid or missing from the request. It can also happen if the user revokes access to your application.
10004	Service Unavailable	Fusioo is going through scheduled maintenance.
20000	Email or password are invalid	Authentication credentials were missing or incorrect.
20001	Invalid Client Id	The Client Id used is invalid. You can find the correct Client Id from here.
20002	Client Id or secret are invalid	You can find the correct Client Id and Secret for your application from here.
20003	Redirect Uri is invalid	The Redirect Uri must match the one used in your application settings.
20004	Refresh token is issued to a different Client Id	The Refresh token used is being used by another application. Make sure you have the correct Refresh token issued for your application.
20005	You have reached the hourly API rate limit	Returned when a request cannot be served due to the API’s rate limit having been exhausted.
20006	Refresh token is invalid or expired	The Refresh token does not exist or has expired. This can also happen when the user revokes access to your application. You can get a new Access and Refresh token by restarting the Authentication flow.
20007	Invalid user	Only active, regular users can access the API. The user is either Deactivated or marked as a Lite user.
30000	App not found	The specified App does not exist.
30001	App access denied	The user you are authenticated with does not have access to the specified App. Check out the Permissions section for more information.
30002	Cannot create App records	The user you are authenticated with does not have access to create records in the specified App. Check out the Permissions section for more information.
30003	Cannot update App records	The user you are authenticated with does not have access to update records in the specified App. Check out the Permissions section for more information.
30004	Cannot delete App records	The user you are authenticated with does not have access to delete records in the specified App. Check out the Permissions section for more information.
30050	Record validation errors	Field options should be respected when entering data. For example, if a Number Field has a maximum value of 2000, any number greater than that will trigger a validation error.
30051	Record not found	The specified record does not exist.
30052	Record access denied	The record is not accessible to the user you are authenticated with.
30053	Record Limit exceeded	You have exceeded your account record limits.
30054	Concurrent requests error	Happens when records using an auto increment Number Field are created at the same time and resources are locked. To fix, retry or add a delay.
30056	Discussion not found	The specified discussion does not exist.
30057	Content is required	The discussion content is required.
30058	Character limit exceeded	The discussion character limit has been exceeded.
30100	Field used to sort does not exist	The Field used to sort the records does not exist.
30101	Field used is not sortable	Not all Fields can be used to sort the retrieved records.
30102	Cannot access the 'Sort By' Field	The Field used to sort the retrieved records isn't accessible to the user you are authenticated with.
30103	Sort direction is invalid	Value should either be `asc` or `desc`.
30104	Records offset is invalid	The offset should be an integer, with the value greater than `0`.
30105	Records limit is invalid	The limit should be an integer, with the value between `0` and `200`.
30200	Webhook not found	The Webhook does not exist.
30250	File not found	The File does not exist.
30251	Invalid file type	The file type is not allowed.
30252	File size limit exceeded	The file size exceeds the 25MB limit.
30253	Storage limit exceeded	The overall storage of your Fusioo account has been exceeded.
30254	Multiple files are not allowed	Only one file can be attached when creating a file.
30256	File Field access denied	The user you are authenticated with does not have access to the specific File Field.
30105	User not found	The specified user was not found.

Was this article helpful?

Yes 😃 No 😞

Thanks for your feedback!