code, a message, and usually a one-line hint. This page maps each code to what you should try, then covers problems that come from the CLI itself rather than the API.
Error codes
The CLI surfaces the same error envelope and retry rules as the API.Authentication and access
Request problems
Limits and versions
Common issues
userplay: command not found after installing
Your global npm bin directory is not on your PATH. Reopen your terminal, or re-run npm i -g @userplaylabs/cli and check where npm put it with npm bin -g.
Still unauthorized right after logging in
USERPLAY_API_KEY in your environment outranks the account you logged in as. If it holds an old key, that old key is the one being sent.
USERPLAY_READONLY is set. It refuses any non-GET request before it leaves your machine.
--yes:
Still stuck
Send us the command you ran and the error you got:Related articles
Errors
The envelope, and how to branch on a code in your own client.
Global options
The agent-mode failure contract a script can parse.
Authentication
Accounts, keys in CI, and where credentials are stored.
Rate limits
The per-key budget behind a
429 in the terminal.