Errors
Standard error codes and troubleshooting guide for the Mimasa AI API. Consistent error shapes across every endpoint make it possible to write one error handler for an entire integration.
Error Format
All errors return a JSON object with "error" containing "code", "message", and optional "details".
Common Error Codes
400 Bad Request, 401 Unauthorized, 403 Forbidden, 404 Not Found, 429 Too Many Requests, 500 Internal Server Error.
Troubleshooting
Start by checking the HTTP status code and the machine-readable error code in the response body rather than the message text, since messages are informational and may change. A 401 usually means the credential is missing, expired or malformed; a 403 means the credential is valid but its role lacks permission for that resource; a 429 means you should back off and honor the retry header. If an error persists after ruling those out, include the request ID from the response when contacting support.