Errors

For compatibility, error responses from VCAPi are not indicated by HTTP status codes. Instead, they are normal 200 responses with the following format:

<?xml version="1.0" encoding="UTF-8"?>
<content>
  <status>fail</status>
  <error>[error code]</error>
</content>

Common error codes are:

  • none - Indicates that an action which should return a list found no matching items.
  • invalid - Indicates that a non-idempotent action was called with unacceptable parameters.
  • missingdata - Indicates that a non-idempotent action was called without a required parameter.
  • notfound - Indicates that a resources associated with the action could not be found, or that the URL was incorrect.
  • servererror - Indicates that an unknown error occurred when handling the request.