Changes using PUT Without clearFlags Field Don't Save

[Tobechukwu-Njoku]

What went wrong?

If an API call to PUT /books/{id}/metadata omits the optional clearFlags field, the server NPEs in MetadataChangeDetector and rolls back (Lombok @Builder.Default doesn't apply through Jackson's deserialisation path). The UI always sends the field, which is why it wasn't widely noticed. I've attached a zipfile of my logs.

How can we reproduce it?

Use PUT to update a book's metadata via the API

What Build of Grimmory are you on?

Stable

Your setup

Latest (3.2.4) running on Docker on Unraid using MariaDB

Screenshots or error messages (optional)

Here are my logs.

Grimmory-Grimmory-2026-07-04T18-15-56.log

Before submitting

• I've searched existing discussions and this hasn't been reported yet
• I've reviewed this report and have completed it as fully as I can