How much of OpenAPI 3 syntax is currently supported by Collections?

We use composite validations like oneOf in our OpenAPI request body definitions. So far it appears that validation isn’t reflected in Collections generated from an API or mentioned in the associated documentation. Is that correct? If so, is there any info available regarding what elements Collections are unable to reflect and what ends up in the Collection when it is not? (I.e. if oneOf isn’t supported, is it automatically treated as string?)

For any validation elements in OpenAPI that aren’t currently carried over to Collections, are there plans for adding them?

It would be ideal if we didn’t need to separately generate and publish a pretty version of the OpenAPI details, outside Postman, in addition to the pretty Collection documentation, but so far it is looking like that may be necessary. Am I missing anything?

2 Likes