Skip to main content

HTTP Status Codes

HTTP status codes are used to indicate the status of a request.

Success Response (200 - 299)

The following status codes indicate a successful response.
Response Status CodeDescription
200 OKThe synchronous task executed successfully and returned the result.
201 CreatedThe task was created successfully and a new resource was created (e.g., a session).
202 AcceptedThe request has been accepted but not yet processed; it does not indicate the final outcome (e.g., creation of an asynchronous task).
201 CreatedThe task was created successfully and a new resource was created (e.g., a session).
202 AcceptedThe request has been accepted but not yet processed; it does not indicate the final outcome (e.g., creation of an asynchronous task).

Client Error Response (400 - 499)

The following status codes indicate a client error.
Response Status CodeDescription
400 Bad RequestInvalid request parameters (e.g., malformed body, incorrect fields).
401 UnauthorizedUnauthorized (e.g., token expired or invalid).
403 ForbiddenForbidden (e.g., insufficient permissions to access the resource).
404 Not FoundThe requested resource was not found (e.g., incorrect path).
405 Method Not AllowedMethod not allowed (e.g., attempting to create an async task via a synchronous endpoint).
409 ConflictConflict (e.g., attempting to create an asynchronous task that already exists).
423 LockedThe requested resource is locked (e.g., attempting to write to a resource that is currently being written).
429 Too Many RequestsToo many requests (e.g., rate limit or quota exceeded).
451 Unavailable For Legal ReasonsUnavailable for legal reasons.

Server Error Response (500 - 599)

The following status codes indicate a server error. You can try again later. If error continues, please contact us for assistance.
Response Status CodeDescription
500 Internal Server ErrorServer error (e.g., an unknown error occurred on the server).
502 Bad GatewayBad gateway (e.g., an upstream service returned an error).
503 Service UnavailableService unavailable (e.g., our service is experiencing an outage).

MuleRouter Errors

When an asynchronous task request fails, MuleRouter will return an RFC 7807 formatted error body.
status
integer
required
HTTP Status Code. Refer to HTTP Status Codes for more details.
title
string
required
Short title of the error
error_code
integer
required
MuleRouter Error Code. Refer to MuleRouter Error Codes for more details.
instance
string
A URI reference that identifies the specific occurrence of the problem.
type
string
A URI reference that identifies the problem type.
detail
string
Description of the error
For example:
{
  "status": 400,
  "title": "Model Not Found",
  "error_code": 2000,
  "instance": "/vendors/openai/v1/chat/completions",
  "type": "https://mulerun.com/docs/api-reference/error-codes#2000",
  "detail": "The model does not exist."
}

MuleRouter Error Codes

1000 - 1999

These errors indicate that the error is related to creator account.

1000 Creator Not Allowed

The creator is not allowed to access the MuleRouter API.

1001 Invalid or expired token

The token is invalid or expired.

1002 Creator Credits Insufficient

The creator’s credits are insufficient.

2000 - 2999

These errors indicate that the error is related to the model.

2000 Model Not Found

The model does not exist.

2001 Model Unavailable

The model is not supported or unavailable.

2002 Model Parameter Not Supported

The model does not support the parameter.

3000 - 3999

These errors indicate that the error is related to the asynchronous task.

3000 Task Not Found

The task does not exist.

3001 Task Execution Error

The task execution failed.

3002 Task Canceled or Aborted

The task was cancelled or aborted.