LovPics Auth API
The auth API from LovPics — 16 operation(s) for auth.
The auth API from LovPics — 16 operation(s) for auth.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/lovpics-com:lovpics-com-auth-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Virtual Studio Auth API
version: 0.1.0
tags:
- name: Auth
paths:
/api/auth/verify-email-password:
post:
tags:
- Auth
summary: Verify Email Password
description: 'Mobile-only helper: verifies credentials against customers table.
Returns ok=true/false (no token issued).'
operationId: verify_email_password_api_auth_verify_email_password_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/EmailLoginPayload'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/auth/email-login:
post:
tags:
- Auth
summary: Email Login
description: 'Email+password login for the Lovpics app and web (bypasses Supabase OAuth).
Issues a Lovpics app JWT used as Bearer token for the same /api/* endpoints.'
operationId: email_login_api_auth_email_login_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/EmailLoginPayload'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/auth/sync:
post:
tags:
- Auth
summary: Sync Customer
operationId: sync_customer_api_auth_sync_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SyncPayload'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/auth/meta/complete-registration:
post:
tags:
- Auth
summary: Meta Complete Registration Backup
description: 'Client-triggered CAPI CompleteRegistration backup.
Uses event_id reg_{cus_id} — Meta deduplicates with pixel + signup-time CAPI.'
operationId: meta_complete_registration_backup_api_auth_meta_complete_registration_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/MetaCompleteRegistrationBody'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
/api/auth/delete-account/request-otp:
post:
tags:
- Auth
summary: Request Delete Account Otp
description: 'Public endpoint (no login): request OTP to delete an account.
Writes to customer_delete_otp and emails OTP via ZeptoMail.'
operationId: request_delete_account_otp_api_auth_delete_account_request_otp_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/DeleteAccountOtpRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/auth/delete-account/verify-otp:
post:
tags:
- Auth
summary: Verify Delete Account Otp
description: 'Public endpoint: verifies OTP for email.'
operationId: verify_delete_account_otp_api_auth_delete_account_verify_otp_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/DeleteAccountOtpVerify'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/auth/delete-account/confirm:
post:
tags:
- Auth
summary: Confirm Delete Account
description: 'Public endpoint: after OTP verify, mark customer is_deleted=2 and write customer_delete_log.'
operationId: confirm_delete_account_api_auth_delete_account_confirm_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/DeleteAccountOtpVerify'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/auth/me:
get:
tags:
- Auth
summary: Get Current User Info
description: 'Get current user information including customer and credits data.
Returns:
dict: Customer and credits information'
operationId: get_current_user_info_api_auth_me_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
security:
- HTTPBearer: []
/api/auth/profile:
put:
tags:
- Auth
summary: Update Profile
description: 'Update customer profile information.
Args:
profile_data: Profile data to update
current_user: Current authenticated user
Returns:
dict: Updated customer information'
operationId: update_profile_api_auth_profile_put
requestBody:
content:
application/json:
schema:
additionalProperties: true
type: object
title: Profile Data
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
/api/auth/mobile-login/request-otp:
post:
tags:
- Auth
summary: Mobile Login Request Otp
description: 'Generate a 6-digit OTP, store in login_otp_log (lol_type=1 WhatsApp), send WhatsApp template.
Does not require an existing customer — new users verify next and get an account created.
Rows with lol_status=9 are WhatsApp send failures; they are excluded from resend cooldown (see _login_otp_resend_seconds_left).
Per-number rolling daily cap: config MOBILE_LOGIN_OTP_MAX_REQUESTS_PER_DAY / MOBILE_LOGIN_OTP_DAILY_WINDOW_HOURS.'
operationId: mobile_login_request_otp_api_auth_mobile_login_request_otp_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/MobileLoginOtpRequestBody'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/auth/profile/request-mobile-otp:
post:
tags:
- Auth
summary: Profile Request Mobile Otp
description: 'Same WhatsApp OTP flow as mobile-login, but stores lol_type=2 for customers already logged in
(e.g. Google) who must verify a number before it is saved on their profile.
Does not send OTP if this number already belongs to another customer (duplicate check).'
operationId: profile_request_mobile_otp_api_auth_profile_request_mobile_otp_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/MobileLoginOtpRequestBody'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
/api/auth/mobile-login/verify-otp:
post:
tags:
- Auth
summary: Mobile Login Verify Otp
description: Verify pending OTP from login_otp_log. If customers.cus_mobile matches, log in; else create mobile-only customer.
operationId: mobile_login_verify_otp_api_auth_mobile_login_verify_otp_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/MobileLoginOtpVerifyBody'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/auth/profile/verify-mobile-otp:
post:
tags:
- Auth
summary: Profile Verify Mobile Otp
description: Verifies OTP from lol_type=2 flow and saves customers.cus_mobile for the authenticated customer.
operationId: profile_verify_mobile_otp_api_auth_profile_verify_mobile_otp_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/MobileLoginOtpVerifyBody'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
/api/auth/mobile-and-demo:
post:
tags:
- Auth
summary: Update Mobile And Record Demo
description: 'Updates customers.cus_mobile and inserts into demo_requests (for demo scheduling).
Used when the logged-in user has no mobile on file.'
operationId: update_mobile_and_record_demo_api_auth_mobile_and_demo_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/MobileDemoUpdateBody'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
/api/auth/logout:
post:
tags:
- Auth
summary: Logout
description: 'Log out user and update session status in login_log table.
Args:
payload: Logout payload containing optional session_id
current_user: Current authenticated user
Returns:
dict: Logout confirmation'
operationId: logout_api_auth_logout_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/LogoutPayload'
default: {}
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
/api/auth/login-history:
get:
tags:
- Auth
summary: Get Login History
description: 'Get login history for the current user.
Args:
current_user: Current authenticated user
limit: Number of records to return (default: 50, max: 100)
offset: Number of records to skip (default: 0)
Returns:
dict: Login history records'
operationId: get_login_history_api_auth_login_history_get
security:
- HTTPBearer: []
parameters:
- name: limit
in: query
required: false
schema:
type: integer
default: 50
title: Limit
- name: offset
in: query
required: false
schema:
type: integer
default: 0
title: Offset
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
MetaCompleteRegistrationBody:
properties:
method:
anyOf:
- type: string
- type: 'null'
title: Method
fbp:
anyOf:
- type: string
- type: 'null'
title: Fbp
fbc:
anyOf:
- type: string
- type: 'null'
title: Fbc
type: object
title: MetaCompleteRegistrationBody
MobileLoginOtpRequestBody:
properties:
mobile:
type: string
title: Mobile
device_type:
type: integer
maximum: 3.0
minimum: 1.0
title: Device Type
default: 1
country_code:
type: integer
maximum: 999.0
minimum: 1.0
title: Country Code
default: 91
type: object
required:
- mobile
title: MobileLoginOtpRequestBody
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
MobileLoginOtpVerifyBody:
properties:
mobile:
type: string
title: Mobile
otp:
type: string
title: Otp
country_code:
type: integer
maximum: 999.0
minimum: 1.0
title: Country Code
default: 91
fbp:
anyOf:
- type: string
- type: 'null'
title: Fbp
fbc:
anyOf:
- type: string
- type: 'null'
title: Fbc
type: object
required:
- mobile
- otp
title: MobileLoginOtpVerifyBody
LogoutPayload:
properties:
session_id:
anyOf:
- type: integer
- type: 'null'
title: Session Id
type: object
title: LogoutPayload
EmailLoginPayload:
properties:
email:
type: string
title: Email
password:
type: string
title: Password
type: object
required:
- email
- password
title: EmailLoginPayload
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
type: object
required:
- loc
- msg
- type
title: ValidationError
DeleteAccountOtpVerify:
properties:
email:
type: string
title: Email
otp:
type: string
title: Otp
type: object
required:
- email
- otp
title: DeleteAccountOtpVerify
DeleteAccountOtpRequest:
properties:
email:
type: string
title: Email
type: object
required:
- email
title: DeleteAccountOtpRequest
SyncPayload:
properties:
email:
type: string
title: Email
name:
anyOf:
- type: string
- type: 'null'
title: Name
provider:
anyOf:
- type: string
- type: 'null'
title: Provider
provider_id:
anyOf:
- type: string
- type: 'null'
title: Provider Id
skip_login_log:
type: boolean
title: Skip Login Log
default: false
fbp:
anyOf:
- type: string
- type: 'null'
title: Fbp
fbc:
anyOf:
- type: string
- type: 'null'
title: Fbc
type: object
required:
- email
title: SyncPayload
MobileDemoUpdateBody:
properties:
mobile:
type: string
title: Mobile
type: object
required:
- mobile
title: MobileDemoUpdateBody
description: Save mobile on customers + insert demo_requests for dashboard prompt.
securitySchemes:
HTTPBearer:
type: http
scheme: bearer