Export API error code reference
If there is a problem while validating the request or initiating the export, the system returns a 4xx or 5xx status code with a descriptive message in the response body. The following table defines the possible HTTP status codes that might be returned in response to an export request made under abnormal conditions:
Export API error conditions
Missing parameters – the URL did not contain all of the required parameters. The body of the response will list the parameters that were missing, as follows:
Invalid credentials – the URL did not contain a valid username or password. The body of the response will contain the following message:
Internal error – the data could not be read from the staging area due to an internal problem. The body of the response will contain the following message:
Feature is disabled – the entire feature has been disabled by an administrator. The body of the response will contain the following message:
Although more than one error condition can occur for the same request, due to the restrictions of HTTP only one status code can be returned.
Therefore, the status codes are evaluated in the following order of importance: 503, 4xx, 500. The most important error condition is reported in the response.
All 4xx conditions are considered equally important, so the first one encountered takes precedence over the others.