I'm annotating my REST appilication using "@ApiOperation". What I want to do is generating response example and I'm trying to do so by using "responseReference" element of "@ApiOperation" annotation.

Annotating like below returns an error saying "CWWKO1255E: Invalid internal reference: #/definitions/items"

@ApiOperation(value = "Search an item by item_no", notes = "Search an item by inputting number of model or parts", responseReference = "items")

My questions are:

1.Is it possible to refer sample json file located at local server?(same as liberty server installed)

2.If 1 is possible, where in the server the json file shoud be located?

3.Value of "responseReference" is converted to the senense "#/definitions/...". Does this mean my json should use "definition" object?