Response types

mabl indicates the status of API requests with standard HTTP response codes. In general:

  • 2xx response codes indicate success.
  • 3xx response codes indicate redirects.
  • 4xx response codes indicate an error with the API request, such as a missing parameter value or API key.
  • 5xx response codes indicate an error on mabl's end.

Troubleshooting 4xx responses

ResponseDescription
400Invalid or missing parameters
401Invalid or missing authentication - make sure you use Basic Authentication and provide a valid key in the "password" portion
403Unauthorized - the API key does not have the right permissions to make the request, or the request used parameters (like IDs) for a different mabl workspace
404Invalid ID - for example, if you use a test ID for a parameter that requires a test run ID, the mabl API returns a 404

Troubleshooting 5xx responses

5xx responses are rare. If you receive a 5xx response:

  1. Retry the request.
  2. Check the mabl status page.
  3. Reach out to support if a 5xx response persists and there is nothing on the mabl status page.