Reset taskchampion-sync-server sync after client_id change?

[mmeier86]

Hello Taskwarrior team,

I just did the switch from 2.6.2 to 3.0, and it went through without a hitch. Then I set up the taskchampion-sync-server and did my first sync, also without issue.

But then I realised that I had committed the sync.encryption_secret line in the taskrc to my dotfiles repo. So I deleted the taskchampion-sync-server DB file and changed the CLIENT_ID env variable to a new ID and restarted the server.
Then I changed the sync.server.client_id to the new ID in my taskrc and also set a new sync.encryption_secret. But now when running task sync I'm getting this error message:

Failed to synchronize with server: Server Error: https://task.example.com/v1/client/add-version/7cff8103-aaee-4c46-8f91-d2af5a595056 responded with 500 Internal Server Error

And in the server logs I'm seeing:

[2025-11-10T15:34:28Z INFO  actix_web::middleware::logger] 10.8.6.229 "GET /v1/client/get-child-version/7cff8103-aaee-4c46-8f91-d2af5a595056 HTTP/1.1" 404 14 "-" "ureq/2.12.1" 0.005019
[2025-11-10T15:34:28Z ERROR taskchampion_sync_server::web] Internal Server Error caused by:
    clients.latest_version_id does not match parent_version_id
[2025-11-10T15:34:28Z INFO  actix_web::middleware::logger] 10.8.6.229 "POST /v1/client/add-version/7cff8103-aaee-4c46-8f91-d2af5a595056 HTTP/1.1" 500 58 "-" "ureq/2.12.1" 0.117201

Is there some kind of reset I would need to execute after switching the sync.server.client_id so that TW recognizes that it needs to do a full fresh sync?

[mmeier86]

Hm, I got the issue somewhat solved. I went into the local taskchampion sqlite DB and removed the entry in the sync_meta table. Then I ran the following SQL query:

UPDATE operations
SET synced = 0

After that, the sync went through without issue. Would there have been a simpler solution which doesn't involve SQL queries?

[djmitche]

The error you saw is actually just a bug -- GothenburgBitFactory/taskchampion-sync-server#154. It's fixed in the latest taskchampion-sync-server version.

[mmeier86]

Argh, I saw that bug but thought it wasn't my issue because it mentioned the error just suddenly appearing, not specifically a change of client_id and encryption secret.

And I completely overlooked the new taskchampion-sync-server release as I only looked in the repo's releases, not the tags.

Thank you for the answer.