[Feature request] Expose the status of the connection to Spotify API in the metrics and/or special route

[Byh0ki]

Hello,

Following the recent changes in Spotify API policies (🤬), the account I used to setup the Spotify App was no longer meeting the requirements (premium + less then 5 users associated). I've only discovered this issue after a few days (and thus I have a big hole in the collected infos) when I tried to login on the UI and I was getting a 403 and a login loop. After checking the logs, I've noticed that the your_spotify server was getting errors/403 since the API policies changes but was failing "silently" (only in the logs).

Would it be possible to expose a metric to get the current status of the connection with Spotify API? Maybe a simple boolean or better a timestamp of the last successful data retrieval so that we can setup metrics based alerts?

Another way of exposing that would be to expose an endpoint that would give the status. In addition to Prometheus metrics, I also have external monitoring system that watches / but fetching the / on the server always answered 200 even if nothing was working in the backend 😅

[Byh0ki]

Hello,

A new set of policies will take place in the coming months regarding the Apps' token.

Here is the mail I've just received

Further to the updates posted on our Developer Blog on June 18, 2026, we're writing to let you know that, starting July 20, 2026, refresh tokens issued by your Spotify app will expire after six months.

This change applies to all apps registered on Spotify for Developers, including yours.
What this means for your app: Once a refresh token expires, attempts to use it to obtain a new access token will return an invalid_grant error. Your app must handle this case by discarding the stored token and sending the user through the sign-in flow again to obtain a new one.
What you need to do:

• Handle invalid_grant errors: Make sure your app handles invalid_grant errors on token refresh by redirecting users to sign in again.
• Discard expired tokens: Do not retry a failed refresh — discard the stored token first.
  Test your reauthorization flow: Test your app's reauthorization flow before July 20, 2026 to avoid disruption for your users.

Other then to verify that the app support the invalid_grant errors, I think it echoes to the original issue to properly expose the status of the connection to Spotify to allow alerting.