When the descriptive text of an Option Value is changed, the Catalog Items that use that value are marked as modified and will be returned by the Catalog API for a “modified since” (updated_at > yyyy-mm-dd) Search request.
Changing the Display Name on an Option definition does not behave the same way (at least when changed via the Square Dashboard UI), so the client is not automatically notified of this (potentially important) change in product definition data via that API request.
Please have any change to the display_name of a CatalogItemOption object mark the catalog items that use that Option as modified as a side effect, to be consistent with the Option Value behavior.
Thank you.