Firefly III (API) update for September 2026


Hello everybody!

Long time no talk. This mailing list has been pretty low-volume and rightly so. I wouldn't want to spam all of you with weird nonsense. But now there's a small update on the new release and the API changes it will bring. TL;DR: not many changes. The new Firefly III v6.7.0 will probably be released early next week.

First, here is a diff file you can check out. It lists all the changes, but since some fields are dynamic, it can be noisy.

The most important changes are:

  • You can no longer update currencies as a non-owner.
  • Dropped an auto-complete endpoint
  • Added a new one
  • Cron jobs are now per user, if you're not using the static cron token only the current user's data will be affected. The return array is expanded to reflect this.

Other than that, no real changes. But as usual, I appreciate your feedback. Especially when the swagger docs are different from the actual docs.

Finally, I am considering supplying the API docs with the actual release. So it would be available at your-installation.example/api/docs or something like that. If you have any thoughts on that (yay, nay, preferred URL) please let me know.

That's it, thanks for reading!

Cheers,
James

PS: this update was written entirely without AI or LLM assistance so any errors are totally my own.

Firefly III

I'm the developer of Firefly III and in this newsletter I talk about the technology of Firefly III and upcoming (API) so software developers know what the future will bring.

Read more from Firefly III

Hello everybody! I bet you didn't expect to hear from me so soon. Tough luck! I just want to share a small API update with you that will be part of the next release. That release should go out this weekend. Changes In Firefly III v6.7.8 you can expect the following to be different. You can give categories a color, like FF0000 (no #). Firefly III doesn't use this, but it may be useful in your app and now supported natively. If you're interested, I will expand this to other objects. There is a...

Hi everybody! I hope this is "low volume" enough for everybody out there. I just wanted to share some small updates with you, and get your feedback on an idea I have. finishBatch API endpoint New in the API docs is the finishBatch endpoint. It is designed for users with lots of rules and webhooks, and when you enable batch processing in your /settings (this will apply to ALL users) newly submitted transactions that submit "batch_submission": false will not yet be processed untill some...

Hello everybody, Thanks again for signing up! Today I want to share a few upcoming changes that will change how you interact with Firefly III, and transactions. The changes are small but could be significant. New settings New system wide settings will replace environment variables. This includes the ability to download exchange rates, and some others. This will help people who have a hard time with environment variables or simply don't want to restart Firefly III for these changes to go into...