is it possible to add description to JSON Profile fields? I would be very useful for Swagger JSON
For JSON profiles each field name itself a description. If you are looking at additional descriptions or comments, this option is not available currently. Another workaround would be, sending a header record with desired descriptions.
If you haven't this here's the Swagger specification file reference for the API component that describes from where it pulls the various Swagger values. In looking at Swagger examples, I haven't really seen object field-level descriptions. Are you referring to the parameters? Do you have an example of what you're trying to achieve that you can share?
json schema does allow for "title" and "description" properties, but boomi does not yet support them.
Retrieving data ...