Estoy documentando una API con documentos de Swagger. Tengo varios puntos finales que comparten un conjunto común de propiedades base. Me gustaría usar $ ref para referirme a ese conjunto de propiedades base y luego extender esas propiedades con propiedades adicionales que son exclusivas de cada punto final. Imaginé que funcionaría de esta manera, pero esto no es válido:

"properties": {
    "$ref": "#/definitions/baseProperties",
    unique_thing": {
      "type": "string"
    },
    "another_unique_thing": {
      "type": "string"
    }
 }