Forum Discussion

alex-savage's avatar
alex-savage
Occasional Contributor
5 years ago

Consistency request: Where should we put operationId?

In an attempt to align ourselves I would like to propose we collectively decide on the location of operationId in an API def:

The SwaggerHub example found here: https://swagger.io/docs/specification/paths-and-operations/ has it located above the summary and description tags:

but also beneath the description (my preference)

 

How do you do it and can we agree on a standard so designers don't have to think / doubt on its location?