get:
  tags:
    - authentication
  summary: Verify an email address
  parameters:
    - in: path
      name: code
      schema:
        type: string
      required: true
      description: a valid confirmation code
      example: f8c4a54a-47ae-40f5-a0a5-356d6a35c24e
  responses:
    "200":
      description: Email address verified, or confirmation code was incorrect
      content:
        application/json:
          schema:
            allOf:
              - type: object
                properties:
                  title:
                    type: string
                  error:
                    type: string
                    description: Translation key for client-side localisation
                  alreadyValidated:
                    type: boolean
                    description: set to true if the email was already validated
                required:
                  - title
              - $ref: ../../components/schemas/CommonProps.yaml#/CommonProps