Navii Pro

Use your Navii Pro license key to unlock premium API options such as themed packs while the free API stays anonymous and backwards-compatible.

Get a license

Buy Navii Pro at https://navii.dev/pro. Today that URL sends you straight to checkout; later it may become a pricing page. API clients should keep linking to it either way.

After purchase, Polar emails your license key. The same key unlocks the Figma plugin and Pro-only hosted API options.

API auth

Pass the license key as a bearer token when you request a Pro-only option:

curl -H "Authorization: Bearer <license_key>" \
  "https://api.navii.dev/avatar/alice?packs=accra-gallery"

Keep using ordinary unauthenticated URLs for free options:

https://api.navii.dev/avatar/alice?size=128

Premium packs

Navii Pro includes four premium pack systems today. Each pack keeps the same seed deterministic while changing the visual world the avatar belongs to.

PackIDBest forExamples
Accra Galleryaccra-galleryContemporary Ghana-inspired profiles, community pages, and editorial identity.
Accra Gallery example: adwoaAccra Gallery example: kwekuAccra Gallery example: selasi
Lagos Danfolagos-danfoBright Lagos/Nigeria identity with route-line energy and danfo yellow accents.
Lagos Danfo example: ekoLagos Danfo example: yemiLagos Danfo example: sade
Nairobi Matatunairobi-matatuNairobi-inspired social, creator, and city-culture surfaces.
Nairobi Matatu example: matatuNairobi Matatu example: ngong46Nairobi Matatu example: route-46
Command Centercommand-centerSaaS teams, workspaces, bots, integrations, projects, and customer lists.
Command Center example: workspace-primaryCommand Center example: project-retentionCommand Center example: integration-slack
 
curl -H "Authorization: Bearer <license_key>" \
  "https://api.navii.dev/avatar/workspace-primary?packs=command-center&style=neutral"

What requires Pro

OptionAuth required?Notes
packs=...YesPremium themed packs such as accra-gallery, lagos-danfo, nairobi-matatu, and command-center.
pro=1YesAuth probe for testing whether a license key is accepted. Renders the same avatar after auth succeeds.
Base avatar paramsNosize, palette, background, mood, animated, tileBg, and title stay anonymous.

Error responses

Missing Pro auth returns 401 with an upgrade URL:

{
  "error": "pro_auth_required",
  "message": "This option requires Navii Pro. Get a license at https://navii.dev/pro.",
  "upgradeUrl": "https://navii.dev/pro"
}

Invalid, revoked, expired, or wrong-product keys return 401:

{
  "error": "invalid_license",
  "message": "The Navii Pro license key is invalid or inactive. Get a license at https://navii.dev/pro.",
  "upgradeUrl": "https://navii.dev/pro"
}

If Polar cannot be reached or returns an invalid response, Navii returns 502:

{
  "error": "license_check_unavailable",
  "message": "License verification is temporarily unavailable."
}

Security notes

  • Do not put a license key in public frontend code unless you are comfortable with users seeing it.
  • Prefer server-side calls, CLI usage, build scripts, or backend SDK helpers for Pro API requests.
  • License checks are cached in-process for 24 hours to keep rendering fast and avoid hitting Polar on every avatar request.