# Error Codes MAXIR AI uses standard HTTP response codes to indicate the outcome of API requests. Generally, codes in the `2xx` range indicate success; codes in the `4xx` range indicate a client error (e.g., invalid parameters); codes in the `5xx` range indicate a server error (these are less common). --- ## API Errors | Error Code | Error Message | Description | | :- | :- | :- | | `400` | Bad Request | Invalid parameters. | | `401` | Unauthorized | Invalid API Key. | | `402` | Request Failed | Parameters are valid, but the request could not be completed. | | `403` | Forbidden | The API Key used lacks the required permissions for this operation. | | `404` | Not Found | The requested resource does not exist. | | `409` | Conflict | Request conflicts with another operation (e.g., using the same idempotent key). | | `429` | Too Many Requests | Too many requests sent in a given amount of time, exceeding the limit. | | `500`, `502`, `503`, `504` | Server Errors | An error occurred on the MAXIR AI side (less common). | --- ## Error Types | Error Type | Description | | :- | :- | | `authentication_error` | Authentication error, API Key is invalid, expired, or revoked. This could be due to input errors, formatting issues, or potential security problems. | | `invalid_request_error` | Request error, the request contains invalid parameters. | | `internal_server_error` | Internal server error, indicating a server-side issue occurred while processing the request; could be a temporary problem, bug, or system failure. | | `idempotency_error` | Idempotency error, occurs when the same idempotency key is used for different API interfaces or parameter sets. | | `rate_limit_error` | Rate limit error, your team has exceeded the limit of 20 API requests per second. | | `permission_error` | You do not have permission to perform this operation. (Operation: %s, Resource: %s.) | --- ## Client Error Codes | Error Code | Error Message | HTTP Status Code | Description | | :- | :- | :- | :- | | `300001` | Invalid parameters *`error_details>`* | 400 | Missing required parameters or parameter configuration errors. Please check that all parameters are correctly set. | | `300002` | No permissions *``* | 200 | You do not have the necessary permissions to perform this action. | | `300003` | *``* not found | 200 | The specified resource does not exist in the project. Please verify that the resource ID is correct. | | `300004` | Invalid file extension | 200 | Unsupported file extension. Supported extensions include **.csv**, **.tsv**, **.md**, **.mdx**, **.json**, **.txt**, **.pdf**, **.pptx**, **.ppt**, **.doc**, **.docx**, **.xls**, and **.xlsx**. | | `300005` | Empty file | 200 | The file is empty, please verify the uploaded file is correct. | | `300006` | Insufficient storage space | 200 | Not enough available storage space to upload the file. Please upgrade your capacity plan first. | | `300007` | Failed to upload the file | 200 | An error occurred while uploading the file. Please check if the file format is supported and try again. | | `300008` | An error occurred while generating the presigned URL | 200 | An error occurred while generating the presigned URL. Please check that all parameters are set correctly and try again. | | `300009` | The number of sessions has reached the upper limit | 200 | The maximum number of sessions has been reached. Please delete unnecessary sessions and try again. | | `300011` | Fail to create datasource | 200 | Unable to create datasource due to an internal error. | | `210020` | Something went wrong during job execution. Please try again. | 400 | Job execution failed, please try again later. | | `210021` | Job quota exceeded | 400 | Insufficient job quota, please upgrade your job plan. | | `210022` | Question too long | 400 | The question is too long, supports a maximum of 6000 characters. | | `210023` | Selected files are not all ready | 400 | Some of the selected files have not yet completed synchronization. | | `210024` | Text too long for TTS service, limit is 5k characters. | 400 | The input text exceeds the 5000-character limit, please shorten the text. | | `210025` | Too many selected files in the query | 400 | Too many files selected in the query. | | `210026` | Invalid analysis | 400 | Data analysis failed, please try again later or set `stream` to true and reinitiate the task. | --- ## Server Error Codes | Error Code | Error Message | HTTP Status Code | Description | | :- | :- | :- | :- | | `9999` | Internal server error | `500` | The request could not be processed due to an unknown error. | | `201` | Rate limit reached for requests | `429` | Requests exceeded the allocated limit. Currently, each team can send up to 20 API requests per second. | | `1002` | Expired credentials | `403` | The provided credentials have expired and are no longer valid; you may need to update or refresh the credentials. | | `1003` | Insufficient authentication | `403` | The authentication information provided is insufficient or incomplete; please ensure all necessary authentication information is included. | | `1004` | Bad credentials | `403` | The credentials provided are incorrect or improperly formatted; please verify the credentials are correct. |