- Token Valid — the token is authorized and data should flow.
- Token Expired — the token has expired or been revoked; refresh it.
Where to look
- A widget shows a data error and you want to know whether re-authorization is needed.
- You just refreshed a connection and want to confirm it’s working.
- You’re debugging a report that depends on a specific connection.
If a connection shows Token Expired
- Click Refresh (project tab) or Refresh token (Settings) to start a fresh OAuth flow. Your account selection is preserved.
- Complete the OAuth flow with the same login. The badge returns to Token Valid.
- If refresh doesn’t resolve it, the authorizing user’s access in the source platform may have been revoked — check the platform’s admin for the token’s status.
The API exposes a
POST /v1/datasources/test endpoint that takes an auth_id and returns { connected, message }, plus POST /v1/data/test to test a connection against the data service. See the API reference for details.