For example, to refer to the path /blogs/{blog_id}/new~posts, you would use:
$ref: '#/paths/~1blogs~1{blog_id}~1new~0posts'
The / and ~ are encoded to ~1 and ~0 respectively. However, the curly braces around blog_id aren't percent-encoded (RFC3986), and this throws an error on editor.swagger.io:
The $ref should be #/paths/~1blogs~1%7Bblog_id%7D~1new~0posts
On https://swagger.io/docs/specification/using-ref/#escape, there's a section that says:
The
/
and~
are encoded to~1
and~0
respectively. However, the curly braces aroundblog_id
aren't percent-encoded (RFC3986), and this throws an error oneditor.swagger.io
:The $ref should be
#/paths/~1blogs~1%7Bblog_id%7D~1new~0posts