Open the editorEditor
Troubleshooting

API, CLI and CI messages

What the Mokxi API, the command line tool and the GitHub Action mean by their plan and limit messages.

Open the editorAll the docs

Mokxi teamTroubleshooting

What you see

The CLI prints an error as mokxi: <message> (<code>, <request id>). The API returns the same message and code in its JSON answer. The code in brackets is the heading below. Send the request id when you write to us.

How each tool works is in the Mokxi API, the command line tool and CI; the VS Code extension is in GitHub and VS Code.

Simulation minutes (quota_exceeded)

"You have used all N simulation minutes your plan includes this month." Simulated time run through the API counts toward a monthly amount: 100 minutes on Free, 2,000 on Pro, Student, Teacher and Classroom, and 5,000 on Ultra (no longer sold; accounts that have it keep it). On Teacher and Classroom the teacher and their class share one pool, so the message may say "your class" instead. The count starts over on the first of the month (UTC), which the message names. A run that started under the limit always finishes, and nothing is ever charged for going over. Circuits run in the editor never count.

Too many requests (rate_limited)

  • "Your plan allows N requests a minute per token" or "N simulations an hour per token". 60 requests a minute and 30 simulations an hour on Free, 600 of each on the paid plans. Wait the seconds the Retry-After header gives.
  • "Too many requests without a token; send one for your plan limit."
  • "Duration is X ms; your plan runs at most N ms of simulated time per request." 10 seconds of simulated time a run on Free, 60 on the paid plans. Split a long run into shorter ones.

Tokens (unauthorized, insufficient_scope, token_limit)

  • "Send your token as "Authorization: Bearer mkx_..."", "that token is not valid", "was revoked" or "has expired". Make a new token on API tokens in Settings, or sign in again with mokxi login.
  • "This token does not have the ... scope." Make a token with that scope ticked: simulate for runs, projects:read and projects:write for projects.
  • "Your plan keeps N API tokens at once; revoke one first." 5 on Free, 25 on the paid plans.
  • "That code is unknown or expired; start again" (mokxi login). Run the login again and approve the new code within a few minutes.

Plan needed (license_required)

  • "Mokxi for VS Code is part of Pro." Start the 7-day free Pro trial, or choose Pro on /pricing.
  • "Mokxi CI is free for public repositories." Runs from the GitHub Action, or from the CLI inside a CI job, on a private repository need a CI token from a Pro account (set it as MOKXI_TOKEN, or the Action's token input). CI for private repositories comes with Pro, the student price, Lifetime, Classroom and the trial, and with Ultra for accounts that still have it. Running a sketch on your own computer with mokxi run stays free, with no account.
  • "... You can keep using it until then." (December 11, 2026) A notice, not an error: accounts that used VS Code or CI before the change keep it until that date.

Still stuck

Write to us from /support with the exact words and the request id.