type: object
properties:
  id:
    type: string
    description: 'A unique identifier'
    example: '1jDe1e5eF_IkaYPuoIYX'
    readOnly: true
  title:
    type: string
    example: 'What project should our neighbourhood invest in for the next year?'
    description: 'The title of the poll'
  candidates:
    type: array
    description: The candidates being voted in a poll.
    minItems: 2
    maxItems: 20
    items:
      $ref: ./candidate.yaml
  mentions:
    type: array
    description: The mentions on which one participant vote to a candidate.
    minItems: 2
    maxItems: 10
    items:
      $ref: ./mention.yaml
  participants:
    type: array
    description: The participants that are allowed to participate to the election.
    items:
      $ref: ./participant.yaml
  restrict_participants:
    type: boolean
    description: True if anyone can participate to this poll, False otherwise.
    example: false