Currently, using $ref in a parameters does not work:

"parameters": [
{
"$ref": "#/parameters/UserId"
}

*this can cause the path to not show up as a service object method

Instead, we have to define it directly in the parameters:

"parameters": [
{
"name": "UserId",
"in": "path",
"description": "User Id",
"type": "string",
"required": true
}
]

Although, this feature does exists in Swagger 2.0:

https://stackoverflow.com/questions/27005105/swagger-openapi-use-ref-to-pass-a-reusable-defined-parameter

Would like support parameter $ref for the REST broker in the future.