Improve error messaging when API and server versions mismatch #2807

Open
opened 2026-02-28 20:29:09 -06:00 by GiteaMirror · 0 comments
Owner

Originally created by @coderabbitai[bot] on GitHub (Jan 12, 2026).

Problem

When the API client version and server version mismatch, the application shows cryptic error messages that don't clearly indicate the root cause. For example, when using an older API version (v25.12.0) with a newer server version (v26.1.0), users see errors like:

Error: no such column: custom_reports.trim_intervals

This makes it difficult for users to diagnose that the issue is caused by a version mismatch between the API client and server.

Expected Behavior

When there's a version mismatch between the API client and server, the application should:

  • Detect the version mismatch
  • Throw a clear, friendly error message explaining the problem
  • Guide users on how to resolve it (e.g., "API version X.X.X does not match server version Y.Y.Y. Please ensure both are using the same version.")

Additional Context

This issue was identified when a user was using the lunchflow tool with API version v25.12.0 while running Actual server v26.1.0.

Backlink: https://github.com/actualbudget/actual/issues/6619
Requested by: @MatissJanis

Originally created by @coderabbitai[bot] on GitHub (Jan 12, 2026). ## Problem When the API client version and server version mismatch, the application shows cryptic error messages that don't clearly indicate the root cause. For example, when using an older API version (v25.12.0) with a newer server version (v26.1.0), users see errors like: ``` Error: no such column: custom_reports.trim_intervals ``` This makes it difficult for users to diagnose that the issue is caused by a version mismatch between the API client and server. ## Expected Behavior When there's a version mismatch between the API client and server, the application should: - Detect the version mismatch - Throw a clear, friendly error message explaining the problem - Guide users on how to resolve it (e.g., "API version X.X.X does not match server version Y.Y.Y. Please ensure both are using the same version.") ## Additional Context This issue was identified when a user was using the lunchflow tool with API version v25.12.0 while running Actual server v26.1.0. Backlink: https://github.com/actualbudget/actual/issues/6619 Requested by: @MatissJanis
GiteaMirror added the tech debtAPIhelp wanted labels 2026-02-28 20:29:09 -06:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/actual#2807