Reusable object properties?

Hi everyone,

I think Swagger UI is a great tool - thanks for making it!

I particularly like the fact that you can reuse definitions, parameters and responses to make the YAML code more modular and was wondering if there’s any way to do the same for object properties? Some of my object properties are the same as parameters I’ve defined elsewhere and it would great if I could use a single reference for both.

Is there any way of doing something like this?

paths:
  /pet:
    get:
      tags:
      - "pet"
      summary: "Add a new pet to the store"
      description: ""
      produces:
      - application/json
      parameters:
      - $ref: "#/parameters/id"
      responses: 
        405:
          description: "Invalid input"
        200:
          schema:
            title: Pet
            type: object
            required: [id, name]
            properties:
              $ref: "#/parameters/id" # Doesn't work :( 
              name:
                type: string
                description: The new pet's name.

parameters:
  id:
    name: id
    in: path
    type: integer
    required: true
    description: The ID.

[webron]

Not OOTB. At some point we plan on introducing a way to hide all models, but not some. You can always write your own plugin to support any behavior you want.

[thales-gaddini]

Hi webron,

In your example, “id” will appear in the Models. Is there a way to prevent that? Or some other way to make a reusable “object” that is not exposed in the UI?

Thanks!