app/controllers/users/confirmations_controller.rb

@@ -0,0 +1,18 @@
+class Users::ConfirmationsController < Devise::ConfirmationsController
+  clear_respond_to
+  respond_to :json
+
+  def show
+    super do |resource|
+      if resource.errors.empty?
+        render json: resource, status: :ok
+      else
+        render json: {
+          message: 'Record invalid',
+          errors: resource.errors.full_messages
+        }, status: :unprocessable_entity
+      end
+      return
+    end
+  end
+end

config/routes.rb

@@ -1,11 +1,14 @@
 # Copyright (C) 2024 Manuel Bustillo
 
 Rails.application.routes.draw do
+  devise_for :users, skip: [:registration, :session, :confirmation]
   devise_scope :user do
     post 'users', to: 'users/registrations#create'
 
     post '/users/sign_in', to: 'users/sessions#create'
     delete '/users/sign_out', to: 'users/sessions#destroy'
+
+    get '/users/confirmation', to: 'users/confirmations#show', as: :confirmation
   end
 
   mount Rswag::Ui::Engine => '/api-docs'

spec/requests/users/confirmations_spec.rb

@@ -0,0 +1,20 @@
+require 'swagger_helper'
+
+RSpec.describe 'users/confirmations', type: :request do
+
+  path '/users/confirmation' do
+    get('confirm user email') do
+      tags 'Users'
+      produces 'application/json'
+
+      parameter name: :confirmation_token, in: :query, type: :string, required: true
+
+      response(200, 'confirmed') do
+        schema Swagger::Schema::USER
+        xit
+      end
+
+      response_422
+    end
+  end
+end