Reminder for anyone who’s here but not too sure what OneNote is.
You wouldn’t create a modern UI by just exposing all the features of your software.
You design by what tasks your end users are trying to achieve.
APIs are no different.
As we moved away from JSON for our page to HTML, we needed an easy way to pass images in a single round trip.