[API] Outdated docs?

[MessiasLima]

https://docs.umami.is/docs/api

The documentation says we should hit https://api.umami.is for using the Umami API. So initially i though we should use https://api.umami.is/me for example.

Turns out that it does not work and we always need to add /v1 after the host. So the "correct" is https://api.umami.is/v1/me.

However we are on version 3.0.3, and the documentation treats v2 as an old version.

Where this v1 came from?
Shouldnt it be v3 instead?
Should it even be there?

[lokeshwardewangan]

Yeah this confused me too at first 😅

The /v1 in the API URL isn’t tied to the Umami app version (like v2, v3, etc). It’s just the API version namespace, and it hasn’t changed even though the app itself is now on v3.

So:

• App version → v3.x (what you install/use)
• API path → still /v1/...

That’s why:

• ❌ https://api.umami.is/me → won’t work
• ✅ https://api.umami.is/v1/me → correct

The docs mentioning v2/v3 are about the application releases, not the API path version — which is definitely a bit misleading.

So yeah, /v1 is expected for now and not a mistake, just outdated/unclear docs 👍