/api/v1/users:

  post:

    tags:

      - user

    summary: Signup the a new customer (user)

    description: Creates a new customer (user), who can 

                 login and do the shopping.

    operationId: signUp

    requestBody:

      content:

        application/xml:

          schema:

            $ref: '#/components/schemas/User'

        application/json:

          schema:

            $ref: '#/components/schemas/User'

    responses:

      201:

        description: For successful user creation.

        content:

          application/xml:

            schema:

              $ref: '#/components/schemas/SignedInUser'

          application/json:

            schema:

              $ref: '#/components/schemas/SignedInUser'