type: object properties: id: type: integer description: A unique identifier. readOnly: true example: 4 name: type: string description: Unique but short name of the proposal. example: A new school ballots: type: array description: The ballots received by this proposal. items: $ref: ./ballot.yaml description: type: string description: An optional description of the proposal example: This school would welcome 500 pupils. required: - name