Ask a Question

Vendor extension on array parameter items node

Occasional Visitor

Vendor extension on array parameter items node

This might not be currently allows on the items node per

I came across this:



        "parameters": [
            "name": "parameterName",
            "in": "body",
            "description": "Parameter description",
            "required": true,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "x-my-vendor-extension": {


 The vendor extension here was used to provide a GUI picker for the items inside the array, where the picker returns a single item, rather than the whole array.

Could it be the above structure is currently an out-of-spec placement for the vendor extension?

SmartBear Alumni (Retired)

Hi @daviburg, your example is valid - extensions are allowed inside Schema Objects. For a full list of places where extensions are allowed, look for  ^x-  in the OpenAPI 2.0 Specification text.

Helen Kosova
SmartBear Documentation Team Lead
Did my reply answer your question? Give Kudos or Accept it as a Solution to help others. ⬇️⬇️⬇️
Showing results for 
Search instead for 
Did you mean: