ContributionsMost RecentMost LikesSolutionsRe: Tagged API methods vanish when using $ref parameters D'oh! Yep, you're right. POST is what I wanted. Still have the problem, though. Here's without the $ref to '#/parameters/qwerty' And here's with the $ref: Thanks, Charlie Tagged API methods vanish when using $ref parameters I'm trying to use $ref parameters YAML to represent a common body for multiple PUT/POST request documentation, but when I do, the API calls vanish alltogether, along with all other API calls with the same tag. Using the following sample editor, when I click over to Interactive API Docs, the Blah API tag will appear, but the Foo API tag does not. If I remove the $ref from line 22, the Foo tag will appear in the interactive docs. As far as I can tell, the syntax is correct, and I get the "valid {...}" message at the top of the API page. I can duplicate the body definition (and am currently doing this), but it would obviously be more convenient to be able to use the common reference. What am I doing wrong here? Thanks