Troubleshooting

Use this page to diagnose public CLI usage problems. Examples show commands only.

Command not found

Confirm the CLI is installed and your shell can find global npm binaries.

npm install --global @faurya/cli

faurya --version

You can also run the package directly:

npx @faurya/cli --version

Unsupported Node.js version

The CLI requires Node.js 20 or newer.

node --version

Not logged in

Log in and confirm your account.

faurya login

faurya whoami

Expired or revoked access

Log in again. If access still fails, ask a website owner or admin to check your role and permissions.

faurya login

faurya website list

Access denied

Confirm you are using the correct website and have access to the feature area.

faurya website list

faurya analytics context <websiteId>

Website not found or wrong website ID

List websites again and copy the correct <websiteId>.

faurya website list

Unknown command

Use help for the root command or command group.

faurya --help

faurya analytics --help

Unknown option

View command-specific help. Not every command accepts every flag.

faurya funnels create --help

faurya website setup code --help

Invalid period

Use today, yesterday, last24h, or a lastNd value such as last7d, last30d, or last90d. For other ranges, use explicit dates.

faurya analytics overview <websiteId> --period last30d

faurya analytics overview <websiteId> --from 2026-07-01T00:00:00.000Z --to 2026-07-19T00:00:00.000Z

Invalid filter field

Use one of the documented fields, or inspect the catalog.

faurya analytics catalog <websiteId>

faurya analytics overview <websiteId> --period last30d -F country=US

Invalid filter operator

Use a supported operator such as eq, contains, in, gt, gte, lt, or lte.

faurya analytics revenue <websiteId> --period last30d -F revenue:gt=0

Invalid JSON supplied to --input

Use one valid JSON object and quote it for your shell.

faurya analytics journeys find <websiteId> --input '{"steps":[{"type":"page","value":"/pricing"}]}'

Non-object JSON input

The root value must be an object. Put arrays under a named field such as steps.

faurya funnels analyze <websiteId> --input '{"steps":[{"type":"page","value":"/"}]}'

Using --input and --input-file together

Choose one input source.

faurya funnels create <websiteId> --input-file ./funnel.json

Missing required structured input

Some commands require fields such as steps, goalEvents, recipientEmail, email, role, domain, enabled, componentOrder, or provider setup options.

faurya analytics journeys find --help

faurya alerts create --help

faurya website domain add --help

Invalid cursor

Cursors must come from a previous result for the same command pattern and website. Re-run the first page if the cursor is stale.

faurya analytics events list <websiteId> --period last30d --limit 100

faurya analytics events list <websiteId> --period last30d --limit 100 --cursor <cursor>

Confirmation required

Destructive commands require interactive confirmation or --yes in non-interactive contexts.

faurya funnels delete <websiteId> <funnelId> --yes

Network failure or timeout

Retry a small read-only command first. If it continues to fail, check your network and contact support with safe context from your terminal.

faurya whoami

faurya analytics context <websiteId>

Rate limiting

Reduce script concurrency and retry later.

faurya analytics overview <websiteId> --period last30d

Ask for command-specific help

faurya help analytics visitors

faurya help website integrations

faurya tokens revoke --help