Error Codes
Response format when a request fails and the error codes of each API
When a request fails, the response carries an HTTP status code and a JSON body in the format below. Error codes differ by API group.
{
"error_code": "COURSE_NOT_FOUND",
"message": "Course does not exist.",
"status_code": 404
}AI Tutor API
| HTTP | Error Code | Description | Solution |
|---|---|---|---|
| 400 | INVALID_COURSE_DATA | Invalid course data | Check request data format |
| 400 | InvalidFileFormat | Invalid file format | Check supported file formats |
| 400 | InvalidJsonFormat | Invalid JSON format | Check JSON syntax |
| 400 | ValidationError | Data validation failed | Check required fields and format |
| 401 | NotAuthorized | Authentication failed | Check API key |
| 401 | InvalidAuthHeader | Invalid auth header | Check API key format |
| 404 | COURSE_NOT_FOUND | Course not found | Check course_id |
| 404 | SECTION_NOT_FOUND | Section not found | Check section_id |
| 404 | CLIP_NOT_FOUND | Clip not found | Check clip_id |
| 404 | MATERIAL_NOT_FOUND | Material not found | Check material_id |
| 422 | InvalidParameter | Invalid parameter | Check query/path parameters |
| 500 | InternalServerError | Internal server error | Contact support |
EduAlign OpsAPI
| HTTP | Error Code | Description | Solution |
|---|---|---|---|
| 400 | NotExistMember | Client member email does not exist | Check the email |
| 400 | MismatchedPassword | Password does not match | Check the password |
| 400 | NotActivatedClientMember | Inactive member or inactive client | Contact your Coxwave contact |
| 400 | SigninFailed | Temporary failure while signing in | Retry with the same request |
| 400 | RefreshFailed | Temporary failure while refreshing tokens | Retry with the same request |
| 400 | NotExistClient | Client does not exist | Check the client identifier |
| 400 | InvalidClient | Client of the signed-in account not found | Contact your Coxwave contact |
| 401 | NotAuthorized | Bearer token missing, expired, or invalidated | Refresh the token and retry |
| 401 | InvalidAuthHeader | `Authorization` header does not start with `Bearer ` | Use the `Authorization: Bearer {access_token}` format |
| 401 | InvalidRefreshToken | Refresh token is invalid or expired | Sign in again to get new tokens |
| 403 | OuterClientScopeForbidden | `client_identity` is not under the signed-in client or does not exist | Check `client_identity` with List Child Clients |
| 404 | NotExistSession | Session does not exist or belongs to another client | Check the session_id |
| 422 | RequestValidationError | Malformed query parameter | Check the date format (YYYY-MM-DD) and parameters |