Admin Manual
Internal reference for managing Wandr's users, agent partners, and the shared admin key. This page and everything it links to is only reachable with the admin key — never share it outside the team.
The admin key is a single shared secret (not tied to any individual email or login) that grants full access to every user's and agent's account data across the Users dashboard, the consumer planner's admin mode, and the raw API. Treat it like a master password: don't paste it into chat tools, don't commit it to git, and rotate it (update the Worker secret + this key) if you suspect it's leaked.
On this page
Access & the admin key
There is one admin key for the whole product. It's checked in three places:
This dashboard
Typed into the "Admin key" box on this login screen. Stored in
sessionStorage, so it clears when the browser tab closes — you'll need to re-enter it next session.The consumer planner
Appended as a URL parameter:
wandr.neulab.xyz/?admin=<key>. This persists in localStorage until you log out of the planner, so it survives page reloads.Raw API calls
Sent as an
X-Admin-Key HTTP header directly to the Worker endpoints, for scripting or debugging outside the browser UI.Using the Users / Agents dashboard
The "Partners" and "Users" links in the header both open the same dashboard — the actual distinction is the Users / Agents tab switcher inside the page itself, not which header link you clicked.
Users tab
Consumer accounts (Wanderer/Explorer/Nomad tiers). Search by email or name, see signup stats and a 30-day signup chart, and per-user actions: reset monthly quota, change tier, or delete the account.
Agents tab
Travel-agent partner accounts (agentfree/Starter/Professional/Agency/Enterprise tiers). Same search/reset-quota/set-tier/delete actions, plus a pending-approval queue for new agent signups that need manual review before they can start generating itineraries.
Reset quota
Zeroes out an account's used-this-month counter immediately, without waiting for the monthly auto-reset. Use for support cases (billing disputes, a generation that errored but still consumed quota).
Set tier
Manually overrides an account's plan tier and its quota limit to match. Use when a manual upgrade/downgrade is needed outside the normal PayPal subscription flow (e.g. a comped account, a support goodwill gesture).
Delete
Permanent. Removes the account and its active sessions. There is no undo screen in this dashboard — confirm the email before deleting.
Admin mode on the planner
For testing the planner itself — new features, prompt changes, multi-city flows — without spending real quota against a test account.
How to enter it
Visit
wandr.neulab.xyz/?admin=<key> once. It signs you in as a synthetic admin account with an effectively unlimited quota and stays active across reloads until you explicitly log out.What it's for
End-to-end testing of new planner features (like the multi-city flow) against the real, live AI backend — generating and refining real itineraries without any quota limit or billing impact.
What it isn't
Not a way to see other users' saved itineraries or account data — that's the Users/Agents dashboard's job, not the planner's admin mode.
Do's and don'ts
Do
- Double-check the email before clicking Delete — it's permanent and there's no confirmation undo.
- Use Reset Quota for genuine support cases, not as a routine workaround.
- Prefer the normal PayPal subscription flow for tier changes when possible; use manual Set Tier only for exceptions.
- Log out of admin mode on the planner (or close the tab) on shared/public machines.
- Rotate the admin key if it's ever shared outside the team or pasted somewhere it shouldn't be.
Don't
- Paste the admin key into chat tools, tickets, or anywhere it could be logged or screenshotted.
- Commit the admin key to git, even in a "temporary" test file.
- Use the planner's admin mode as a way to browse or audit other users' data — it doesn't expose that; use the dashboard instead.
- Delete an account without checking the Agents tab too, if the email could belong to either a consumer or an agent account.
FAQ
Why does clicking "Partners" still show the Users tab active?▼
"Partners" and "Users" in the header both load the same dashboard page, which always opens on the Users tab by default. Click the Agents tab inside the dashboard itself to see travel-agent partner accounts.
I lost my session — do I need the key again?▼
This dashboard's key is stored in
sessionStorage, so yes — closing the browser tab clears it and you'll need to re-enter the admin key next time. The planner's admin mode uses localStorage instead, so that one persists across tab closes until you explicitly log out.What tiers exist for consumer vs. agent accounts?▼
Consumers: Wanderer 2/mo free, Explorer 30/mo, Nomad 100/mo. Agents: agentfree 3/mo, Starter 100/mo, Professional 300/mo, Agency 800/mo, Enterprise 2000/mo.
Where do pending agent approvals show up?▼
On the Agents tab of the Users/Agents dashboard, in the pending-approval queue. New agent signups start active on the free agentfree tier automatically — the approval queue is for manual review of paid-tier upgrades and account status changes (suspend/reject), not for gating initial signup.