Settings
Profile, notification preferences, API keys, and plan / billing.
Settings lives at /settings in the web app, accessible from the user menu in the top right. Most options are per-user; plan and billing are per-workspace and admin-only.
Profile
- Display name — how your name appears to teammates and in invite emails you send. Update here instead of in Cognito directly so the app and email From headers stay in sync.
- Email — your sign-in address. Changing your email requires email verification.
Notification preferences
Ankos sends three kinds of emails. You can mute each one independently:
- Assignment emails — when another team member assigns you one or more entries, you get a digest email listing what's newly yours.
- Weekly digest — a Monday summary of the current cycle: readiness %, what moved, what still needs attention.
- Team invites — when someone invites a new member to the workspace, every admin is notified. (This cannot be muted by non-admins since they don't receive it.)
Muting notifications does not affect in-app indicators. You'll still see badges and counts when you sign in.
API keys
API keys authenticate the Ankos CLI so it can upload scan results into your workspace's ledger.
- Create a key — give it a label (e.g. "CI/CD", "laptop", "prod pipeline"). The key is shown once; copy it into your password manager or CI secret store.
- Revoke a key — immediately invalidates it. Any CLI session using that key will fail on the next upload.
- Last used — visible on the key list so you can spot unused keys.
Keys inherit the role of the user who created them. An editor's key can do what an editor can do; an admin's key can do what an admin can do.
API keys grant full CLI-level access as your user. Treat them like passwords. Prefer per-environment keys (one for CI, one for your laptop) over a single shared key.
Plan & billing
Plan and billing are under active development. Today, the Team plan is on a 60-day free trial; after the trial, contact hello@ankos.dev to continue. Self-serve billing with Stripe is coming soon — this section will expand when it ships.
When self-serve billing lands, this section will let admins:
- See the current plan, renewal date, and seat count
- Update payment method and billing email
- Download past invoices
- Upgrade or downgrade between Free CLI, Team, and Enterprise
Categories (admin only)
Admins can add, rename, or override DRL categories for their workspace. Custom categories merge with the baseline so every entry still maps to one code. Useful for:
- Adding a company-specific category for a compensating control
- Relabeling a baseline category to match your internal vocabulary

