postman-app-support icon indicating copy to clipboard operation
postman-app-support copied to clipboard

Body parameter descriptions

Open Sebaroni opened this issue 4 years ago • 16 comments

Is there an existing request for this feature?

  • [X] I have searched the existing issues for this feature request

Is your feature request related to a problem?

Hello! I’m porting OAS3 specs to Postman collections, but I don’t see the tables with the request body parameter descriptions in the documentation section. I was hoping Postman would render those automatically.

Those tables are nested under requestBody in the OAS yaml file.

For example: requestBody: description: This API is used to ... content: application/json: schema: minItems: 1 uniqueItems: true type: array items: required: - call_date - call_identifier - file_name - unit_identifier type: object properties: call_identifier: minLength: 1 type: string description: record identifier. example: 0242ac130004

Describe the solution you'd like

I'd like Postman to automatically render the tables with POST body parameter descriptions.

Describe alternatives you've considered

I'd like to avoid having to enter them manually using markdown.

Additional context

No response

Sebaroni avatar Aug 18 '21 20:08 Sebaroni