# Can we see complex OpenAPI schemas in Postman API Documentation?

**URL:** <https://community.postman.com/t/can-we-see-complex-openapi-schemas-in-postman-api-documentation/15854>\
**Category:** Help Hub\
**Tags:** openapi\
**Created:** [September 14, 2020, 8:25pm UTC](https://community.postman.com/t/can-we-see-complex-openapi-schemas-in-postman-api-documentation/15854 "2020-09-14T20:25:40Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![kenneth.carpenter](https://avatars.discourse-cdn.com/v4/letter/k/b487fb/32.png) [@kenneth.carpenter](https://community.postman.com/u/kenneth.carpenter)\
**Post date:** [September 14, 2020, 8:25pm UTC](https://community.postman.com/t/can-we-see-complex-openapi-schemas-in-postman-api-documentation/15854/1 "2020-09-14T20:25:40Z")

</div>

I’m updating a prior question with a specific example:

Consider this bit of OpenAPI 3 as viewed from Swagger Editor. See how it is telling the client that _function\_arguments_ can be an array of **anyOf** number, string, boolean, as specified in my OpenAPI YAML.

 ![image](https://us1.discourse-cdn.com/getpostman/original/3X/e/b/ebfc4a49a8e322a320290ee96af97bfd71dceee9.png)

Next see how Postman documentation treats the same method. Note that it only suggests that _function\_arguments_ can only be an array of number.

 ![image](https://us1.discourse-cdn.com/getpostman/original/3X/2/3/23a3ff0c039f5f2ea40673bddb1fe0be27a83204.png)

Two specific questions are:

1. Is there any way now, or planned for the near future, for Postman to generate correct documentation for schemas like this one, which use intermediate-level features of OpenAPI? Or are we going to have to document manually in descriptions using Markdown?

2. When validating collections against an API, will requests be fully validated against the original OpenAPI? Or will some fidelity be lost – e.g., in my example above will it only allow a number?

Thanks in advance.