Error handling

Manatal follows the standard HTTP code implementation to indicate whether the request was a success or a failure.

In case of failure, Manatal returns the reason for failure within the details data field.

HTTP CodeDescription
200 - OKEverything worked as expected.
400 - Bad RequestThe request was unacceptable. This is often due to a required parameter missing.
401 - UnauthorizedNo valid API key provided.
402 - Request FailedThe parameters were valid but the request failed.
403 - ForbiddenThe API key doesn't have permissions to perform the request.
404 - Not FoundThe requested resource doesn't exist.
409 - ConflictThe request conflicts with another request (perhaps due to using the same idempotent key).
429 - Too Many RequestsToo many requests hit the API too quickly. We recommend an exponential backoff of your requests,
500, 502, 503, 504 - Server ErrorsSomething went wrong on Manatal's end.