Estou documentando uma API com os documentos do Swagger. Eu tenho vários pontos de extremidade que compartilham um conjunto comum de propriedades de base. Eu gostaria de usar $ ref para se referir a esse conjunto básico de propriedades e, em seguida, estender essas propriedades com propriedades adicionais exclusivas para cada ponto de extremidade. Imaginei que funcionaria algo assim, mas isso é inválido:

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