Verify User Exists

​

Authentication

Authorization: Bearer <your_jwt_token>

​

Request Body

​

Response

​

Examples

​

Successful Request (User Exists)

curl -X POST "http://localhost:8000/api/v1/auth/verify-user" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

{
  "success": true,
  "exists": true,
  "message": "User verified and exists in database"
}

​

User Creation Flow

{
  "error": "User not found in database and creation is in progress.",
  "exists": false
}

​

Error Responses

​

Error: No Token Provided

{
  "error": "No token provided."
}

​

Error: Invalid Token

{
  "error": "Invalid or expired token."
}

​

Error: Invalid Token Payload

{
  "error": "Invalid token payload."
}

​

Implementation Details

1. Token Validation: Verifies the JWT token and extracts user ID and email
2. Database Check: Queries the PostgreSQL database for the user
3. User Creation: If user not found, sends a message to Redis Streams to create the user
4. Response Wait: Waits up to 5 seconds for the Engine to confirm user creation
5. Verification: Checks the database again after creation attempt

​

User Creation Flow

​

Use Cases

​

Dashboard User Verification

const ensureDashboardAccess = async (token) => {
  try {
    const result = await fetch('http://localhost:8000/api/v1/auth/verify-user', {
      method: 'POST',
      headers: { 'Authorization': `Bearer ${token}` }
    });
    
    const data = await result.json();
    
    if (data.success && data.exists) {
      // User exists, proceed to dashboard
      return { canAccess: true };
    } else if (!data.exists) {
      // User creation in progress, retry or show loading
      return { canAccess: false, reason: 'User creation in progress' };
    }
  } catch (error) {
    return { canAccess: false, reason: error.message };
  }
};

​

Related Endpoints

• Login - Initiate authentication flow
• Verify - Complete email verification
• Ensure User - Force user creation