Troubleshooting by error code
The CLI prints a message with the next step. This table lists the kind, the HTTP status and the standard action for each gateway code.
host
Point the base URL at the JembatanAI gateway; MythosCode does this for you, so this appears only with a manual override.
| Code | HTTP | Auto-retry |
|---|---|---|
wrong_api_host | 400 | no |
auth
Check the key with mythoscode status, log in again with mythoscode login, or renew the plan; a suspended key needs an appeal to the operator.
| Code | HTTP | Auto-retry |
|---|---|---|
api_key_missing | 401 | no |
api_key_not_recognized | 401 | no |
api_key_invalid | 401 | no |
api_key_expired | 401 | no |
api_key_inactive | 401 | no |
api_key_suspended | 403 | no |
api_key_revoked | 403 | no |
trial_ended | 403 | no |
order_missing | 403 | no |
payment
Complete the unpaid order, then retry.
| Code | HTTP | Auto-retry |
|---|---|---|
payment_required | 402 | no |
model
The model is not in the plan or does not exist: pick another with mythoscode models.
| Code | HTTP | Auto-retry |
|---|---|---|
store_model_not_allowed | 403 | no |
donor_model_not_allowed | 403 | no |
model_not_found | 404 | no |
model_not_supported | 406 | no |
quota
The token, period or wallet balance is used up or too small for this request: top up or renew, or send a smaller request.
| Code | HTTP | Auto-retry |
|---|---|---|
store_quota_exceeded | 403 | no |
store_period_quota_exceeded | 403 | no |
store_credit_exhausted | 403 | no |
model_credit_exhausted | 403 | no |
payg_balance_empty | 402 | no |
insufficient_quota | 403 | no |
store_credit_short | 402 | no |
payg_balance_short | 402 | no |
rate
Wait and retry; the CLI sleeps the Retry-After the gateway sends.
| Code | HTTP | Auto-retry |
|---|---|---|
rpm_limit_exceeded | 429 | yes |
rps_burst_exceeded | 429 | yes |
plan_rpm_exceeded | 429 | yes |
fup_blocked | 429 | no |
session-cap
Too many parallel requests for the plan or balance: close parallel sessions or wait.
| Code | HTTP | Auto-retry |
|---|---|---|
session_cap | 429 | yes |
store_credit_reserved | 429 | yes |
model_credit_reserved | 429 | yes |
server
Gateway fault, usually transient: the CLI retries with back-off; if it persists, try again in a few minutes.
| Code | HTTP | Auto-retry |
|---|---|---|
key_lookup_failed | 503 | yes |
quota_unavailable | 503 | yes |
ops_process_no_llm | 503 | yes |
store_activation_failed | 500 | yes |
store_config_error | 500 | no |
internal_server_error | 500 | yes |
bad_gateway | 502 | yes |
service_unavailable | 503 | yes |
server_is_overloaded | 503 | yes |
gateway_timeout | 504 | yes |
server_error | 500 | yes |
client
The request was malformed: check parameters, or shrink the context with /compact.
| Code | HTTP | Auto-retry |
|---|---|---|
bad_request | 400 | no |
payload_too_large | 413 | no |
aborted
The request was cancelled on the client side: send it again if still needed.
| Code | HTTP | Auto-retry |
|---|---|---|
request_aborted | 499 | no |
unknown
Unrecognised gateway error: the original detail is shown; report it if it repeats.
| Code | HTTP | Auto-retry |
|---|---|---|
unknown_error | 500 | no |