Skip to Content

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 CodeError MessageDescription
400Bad RequestInvalid parameters.
401UnauthorizedInvalid API Key.
402Request FailedParameters are valid, but the request could not be completed.
403ForbiddenThe API Key used lacks the required permissions for this operation.
404Not FoundThe requested resource does not exist.
409ConflictRequest conflicts with another operation (e.g., using the same idempotent key).
429Too Many RequestsToo many requests sent in a given amount of time, exceeding the limit.
500, 502, 503, 504Server ErrorsAn error occurred on the MAXIR AI side (less common).

Error Types

Error TypeDescription
authentication_errorAuthentication error, API Key is invalid, expired, or revoked. This could be due to input errors, formatting issues, or potential security problems.
invalid_request_errorRequest error, the request contains invalid parameters.
internal_server_errorInternal server error, indicating a server-side issue occurred while processing the request; could be a temporary problem, bug, or system failure.
idempotency_errorIdempotency error, occurs when the same idempotency key is used for different API interfaces or parameter sets.
rate_limit_errorRate limit error, your team has exceeded the limit of 20 API requests per second.
permission_errorYou do not have permission to perform this operation. (Operation: %s, Resource: %s.)

Client Error Codes

Error CodeError MessageHTTP Status CodeDescription
300001Invalid parameters error_details>400Missing required parameters or parameter configuration errors. Please check that all parameters are correctly set.
300002No permissions <error_details>200You do not have the necessary permissions to perform this action.
300003<resource_name> not found200The specified resource does not exist in the project. Please verify that the resource ID is correct.
300004Invalid file extension200Unsupported file extension. Supported extensions include .csv, .tsv, .md, .mdx, .json, .txt, .pdf, .pptx, .ppt, .doc, .docx, .xls, and .xlsx.
300005Empty file200The file is empty, please verify the uploaded file is correct.
300006Insufficient storage space200Not enough available storage space to upload the file. Please upgrade your capacity plan first.
300007Failed to upload the file200An error occurred while uploading the file. Please check if the file format is supported and try again.
300008An error occurred while generating the presigned URL200An error occurred while generating the presigned URL. Please check that all parameters are set correctly and try again.
300009The number of sessions has reached the upper limit200The maximum number of sessions has been reached. Please delete unnecessary sessions and try again.
300011Fail to create datasource200Unable to create datasource due to an internal error.
210020Something went wrong during job execution. Please try again.400Job execution failed, please try again later.
210021Job quota exceeded400Insufficient job quota, please upgrade your job plan.
210022Question too long400The question is too long, supports a maximum of 6000 characters.
210023Selected files are not all ready400Some of the selected files have not yet completed synchronization.
210024Text too long for TTS service, limit is 5k characters.400The input text exceeds the 5000-character limit, please shorten the text.
210025Too many selected files in the query400Too many files selected in the query.
210026Invalid analysis400Data analysis failed, please try again later or set stream to true and reinitiate the task.

Server Error Codes

Error CodeError MessageHTTP Status CodeDescription
9999Internal server error500The request could not be processed due to an unknown error.
201Rate limit reached for requests429Requests exceeded the allocated limit. Currently, each team can send up to 20 API requests per second.
1002Expired credentials403The provided credentials have expired and are no longer valid; you may need to update or refresh the credentials.
1003Insufficient authentication403The authentication information provided is insufficient or incomplete; please ensure all necessary authentication information is included.
1004Bad credentials403The credentials provided are incorrect or improperly formatted; please verify the credentials are correct.