Skip to content

FinceptTerminal is a modern finance application offering advanced market analytics, investment research, and economic data tools, designed for interactive exploration and data-driven decision-making in a user-friendly environment.

payment update

tilakpatel2271ce22f572ab
diff --git a/fincept-terminal-desktop/src/components/auth/PricingScreen.tsx b/fincept-terminal-desktop/src/components/auth/PricingScreen.tsx
index b3696629b..6a4a732b2 100644
--- a/fincept-terminal-desktop/src/components/auth/PricingScreen.tsx
+++ b/fincept-terminal-desktop/src/components/auth/PricingScreen.tsx
@@ -215,12 +215,11 @@ const handleSelectPlan = async () => {
const getPlanCard = (plan: any) => {
const isSelected = selectedPlan === plan.plan_id;
- const displayPrice = plan.price_usd;
- // Use API's is_popular flag
+ // Use API's is_popular flag (set by backend or computed in paymentApi)
const isPopular = plan.is_popular;
- // Only show Best Value badge on the $50 plan
- const isRecommended = plan.price_usd === 50;
+ // Show Best Value badge based on is_popular flag
+ const isRecommended = plan.is_popular;
// Check if this is the current plan
const currentPlanId = session?.user_info?.account_type || 'free';
@@ -282,11 +281,11 @@ const handleSelectPlan = async () => {
<div className="mb-3">
<div className="grid grid-cols-2 gap-1 text-xs">
<div className="bg-zinc-800/30 p-1.5 rounded text-center">
- <div className="text-zinc-400 text-xs">{plan.credits_amount.toLocaleString()}</div>
+ <div className="text-zinc-400 text-xs">{(plan.credits || 0).toLocaleString()}</div>
<div className="text-white font-medium text-xs">Credits</div>
</div>
<div className="bg-zinc-800/30 p-1.5 rounded text-center">
- <div className="text-zinc-400 text-xs">{plan.validity_display}</div>
+ <div className="text-zinc-400 text-xs">{plan.validity_display || `${plan.validity_days} days`}</div>
<div className="text-white font-medium text-xs">Validity</div>
</div>
</div>
@@ -459,7 +458,7 @@ const handleSelectPlan = async () => {
<div className="text-zinc-400 text-xs">
{selectedPlanData ? (
<>
- {selectedPlanData.price_display} • {selectedPlanData.credits_amount.toLocaleString()} credits • {selectedPlanData.validity_display}
+ {selectedPlanData.price_display} • {selectedPlanData.credits.toLocaleString()} credits • {selectedPlanData.validity_display}
</>
) : (
'Select a plan to continue'
diff --git a/fincept-terminal-desktop/src/contexts/AuthContext.tsx b/fincept-terminal-desktop/src/contexts/AuthContext.tsx
index 05c823f59..e3b8ba034 100644
--- a/fincept-terminal-desktop/src/contexts/AuthContext.tsx
+++ b/fincept-terminal-desktop/src/contexts/AuthContext.tsx
@@ -58,20 +58,25 @@ export interface ApiResponse {
status_code?: number;
}
-// Payment related types - Credit-based system
+// Payment related types - Credit-based system (matches backend API)
export interface SubscriptionPlan {
plan_id: string;
name: string;
description: string;
price_usd: number;
- price_display: string;
- credits_amount: number;
- support_type: string;
- support_display: string;
+ currency: string;
+ credits: number;
+ support_type: string; // "community" | "fincept"
validity_days: number;
- validity_display: string;
- is_popular: boolean;
+ features: string[];
+ is_free: boolean;
display_order: number;
+ // Computed fields for UI display (added by frontend)
+ price_display?: string;
+ credits_amount?: number;
+ support_display?: string;
+ validity_display?: string;
+ is_popular?: boolean;
}
export interface PaymentSession {
@@ -411,8 +416,8 @@ const fetchUserProfile = async (apiKey: string): Promise<UserProfileResponse['da
const result = await PaymentApiService.getSubscriptionPlans();
if (result.success && result.data) {
- const plansData = (result.data as any).data || result.data;
- const plans = plansData.plans || [];
+ // result.data is already the array of plans
+ const plans = Array.isArray(result.data) ? result.data : [];
if (plans.length > 0) {
setAvailablePlans(plans);
diff --git a/fincept-terminal-desktop/src/services/paymentApi.tsx b/fincept-terminal-desktop/src/services/paymentApi.tsx
index 80a8c988e..0eadba7b5 100644
--- a/fincept-terminal-desktop/src/services/paymentApi.tsx
+++ b/fincept-terminal-desktop/src/services/paymentApi.tsx
@@ -27,28 +27,31 @@ interface CheckoutRequest {
currency: string; // USD, EUR, INR, etc.
}
-// Response Types
+// Response Types - Matches backend exactly
interface SubscriptionPlan {
plan_id: string;
name: string;
+ description: string;
price_usd: number;
+ currency: string;
credits: number;
+ support_type: string; // "community" | "fincept"
+ validity_days: number;
features: string[];
- // Computed fields for display
- description?: string;
+ is_free: boolean;
+ display_order: number;
+ // Computed fields for UI display (added by frontend)
price_display?: string;
credits_amount?: number;
- support_type?: string;
support_display?: string;
validity_display?: string;
is_popular?: boolean;
- display_order?: number;
}
interface PlansResponse {
- plans: SubscriptionPlan[];
- currency: string;
- total_plans?: number;
+ success: boolean;
+ message: string;
+ data: SubscriptionPlan[];
}
interface CheckoutResponse {
@@ -189,37 +192,39 @@ const makePaymentApiRequest = async <T = any>(
// Payment API Service Class with enhanced debugging
export class PaymentApiService {
// Get all subscription plans from API
- static async getSubscriptionPlans(): Promise<PaymentApiResponse<PlansResponse>> {
+ static async getSubscriptionPlans(): Promise<PaymentApiResponse<SubscriptionPlan[]>> {
const response = await makePaymentApiRequest<PlansResponse>('GET', '/payment/plans');
- // Handle double-wrapped response: response.data might contain {success, data: {plans}}
- let plansData = response.data;
- if (plansData && (plansData as any).data && (plansData as any).success) {
- // Double-wrapped - extract the inner data
- plansData = (plansData as any).data;
- }
+ // Backend returns: { success: true, message: "Success", data: [plans array] }
+ if (response.success && response.data) {
+ const plansResponse = response.data;
+
+ // Extract plans array from the data field
+ const plans = plansResponse.data || [];
- // Add computed display fields to each plan
- if (response.success && plansData?.plans) {
- plansData.plans = plansData.plans.map((plan: any, index: number) => ({
+ // Add computed display fields to each plan
+ const enrichedPlans = plans.map((plan) => ({
...plan,
- // Add computed display fields
- price_display: `$${plan.price_usd}`,
+ // Add computed display fields for UI
+ price_display: plan.price_usd === 0 ? 'Free' : `$${plan.price_usd}/mo`,
credits_amount: plan.credits,
- description: plan.features?.[0] || '',
- support_type: plan.price_usd === 0 ? 'community' : 'priority',
- support_display: plan.features?.find((f: string) => f.toLowerCase().includes('support')) ||
- (plan.price_usd === 0 ? 'Community Support' : 'Priority Support'),
- validity_display: '30 days', // Default to monthly
- is_popular: plan.plan_id === 'standard', // Mark standard as popular
- display_order: index + 1
+ support_display: plan.support_type === 'community' ? 'Community Support' : 'Fincept Support',
+ validity_display: plan.validity_days === 0 ? 'Forever' : `${plan.validity_days} days`,
+ is_popular: plan.plan_id === 'pro', // Mark Pro ($50) as popular
}));
- plansData.total_plans = plansData.plans.length;
- response.data = plansData;
+ return {
+ success: true,
+ data: enrichedPlans,
+ status_code: response.status_code
+ };
}
- return response;
+ return {
+ success: false,
+ error: response.error || 'Failed to load plans',
+ status_code: response.status_code
+ };
}
// Get specific plan details
@@ -227,7 +232,7 @@ export class PaymentApiService {
return makePaymentApiRequest<SubscriptionPlan>('GET', `/payment/plans/${planId}`);
}
- // Create checkout session - Updated to use /payment/checkout/create endpoint
+ // Create checkout session - Updated to use /payment/create-order endpoint
static async createCheckoutSession(
apiKey: string,
request: CheckoutRequest
@@ -250,12 +255,13 @@ export class PaymentApiService {
'X-API-Key': apiKey
};
- // Only send plan_id, not currency (based on API spec)
+ // Send plan_id and currency (based on API spec)
const requestBody = {
- plan_id: request.plan_id
+ plan_id: request.plan_id,
+ currency: request.currency || 'USD'
};
- return await makePaymentApiRequest<CheckoutResponse>('POST', '/payment/checkout/create', requestBody, headers);
+ return await makePaymentApiRequest<CheckoutResponse>('POST', '/payment/create-order', requestBody, headers);
}
// Handle payment success
diff --git a/openapi.json b/openapi.json
new file mode 100644
index 000000000..8b1dc6a56
--- /dev/null
+++ b/openapi.json
@@ -0,0 +1 @@
+{"openapi":"3.1.0","info":{"title":"Fincept API","description":"Modular Financial Data API","version":"3.0.0"},"paths":{"/auth/user/verify-simulate":{"post":{"tags":["authentication"],"summary":"Simulate User Verification","description":"Simulate OTP verification for testing purposes","operationId":"simulate_user_verification_auth_user_verify_simulate_post","parameters":[{"name":"email","in":"query","required":true,"schema":{"type":"string","title":"Email"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/register":{"post":{"tags":["users"],"summary":"Register User","description":"Register new user account","operationId":"register_user_user_register_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserRegistration"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/verify-otp":{"post":{"tags":["users"],"summary":"Verify Otp","description":"Verify OTP and activate account","operationId":"verify_otp_user_verify_otp_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OTPVerification"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/login":{"post":{"tags":["users"],"summary":"Login User","description":"User login with history tracking","operationId":"login_user_user_login_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserLogin"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/verify-mfa":{"post":{"tags":["users"],"summary":"Verify Mfa Login","description":"Verify MFA code and complete login","operationId":"verify_mfa_login_user_verify_mfa_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OTPVerification"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/forgot-password":{"post":{"tags":["users"],"summary":"Forgot Password","description":"Request password reset","operationId":"forgot_password_user_forgot_password_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PasswordReset"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/reset-password":{"post":{"tags":["users"],"summary":"Reset Password","description":"Reset password with OTP","operationId":"reset_password_user_reset_password_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PasswordResetConfirm"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/profile":{"get":{"tags":["users"],"summary":"Get User Profile","description":"Get user profile information","operationId":"get_user_profile_user_profile_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/user/regenerate-api-key":{"post":{"tags":["users"],"summary":"Regenerate Api Key","description":"Regenerate user API key","operationId":"regenerate_api_key_user_regenerate_api_key_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/user/usage":{"get":{"tags":["users"],"summary":"Get User Usage","description":"Get user's API usage statistics","operationId":"get_user_usage_user_usage_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/user/login-history":{"get":{"tags":["users"],"summary":"Get My Login History","description":"Get current user's login history","operationId":"get_my_login_history_user_login_history_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"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"}}}}}}},"/user/subscribe":{"post":{"tags":["users"],"summary":"Subscribe To Database","description":"Subscribe to a database","operationId":"subscribe_to_database_user_subscribe_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseSubscriptionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/user/subscriptions":{"get":{"tags":["users"],"summary":"Get User Subscriptions","description":"Get user's database subscriptions","operationId":"get_user_subscriptions_user_subscriptions_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/user/transactions":{"get":{"tags":["users"],"summary":"Get User Transactions","description":"Get user's transaction history","operationId":"get_user_transactions_user_transactions_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/user/mfa/enable":{"post":{"tags":["users"],"summary":"Enable Mfa","description":"Enable MFA (Multi-Factor Authentication) - Email-based","operationId":"enable_mfa_user_mfa_enable_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/user/mfa/disable":{"post":{"tags":["users"],"summary":"Disable Mfa","description":"Disable MFA (requires password confirmation)","operationId":"disable_mfa_user_mfa_disable_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Password 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":[{"APIKeyHeader":[]}]}},"/user/account":{"delete":{"tags":["users"],"summary":"Delete User Account","description":"Delete user account","operationId":"delete_user_account_user_account_delete","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Confirmation 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":[{"APIKeyHeader":[]}]}},"/user/admin/users":{"get":{"tags":["users"],"summary":"List All Users","description":"List all users (admin only)","operationId":"list_all_users_user_admin_users_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/user/admin/user/{user_id}":{"get":{"tags":["users"],"summary":"Get User Details","description":"Get detailed user information (admin only)","operationId":"get_user_details_user_admin_user__user_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","title":"User Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/admin/user/{user_id}/credits":{"post":{"tags":["users"],"summary":"Manage User Credits","description":"Manage user credits (admin only)","operationId":"manage_user_credits_user_admin_user__user_id__credits_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","title":"User Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Credits Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/admin/stats":{"get":{"tags":["users"],"summary":"Get Admin Statistics","description":"Get system statistics (admin only)","operationId":"get_admin_statistics_user_admin_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/guest/register":{"post":{"tags":["guests"],"summary":"Register Device","description":"Register device and create guest user with temporary API key (50 credits one-time per IP)","operationId":"register_device_guest_register_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeviceRegistration"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/guest/status":{"get":{"tags":["guests"],"summary":"Guest Status","description":"Get guest user status and usage","operationId":"guest_status_guest_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/guest/extend":{"post":{"tags":["guests"],"summary":"Extend Guest Session","description":"Extend guest session if near expiry","operationId":"extend_guest_session_guest_extend_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/guest/usage":{"get":{"tags":["guests"],"summary":"Get Guest Usage","description":"Get guest user's API usage statistics","operationId":"get_guest_usage_guest_usage_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/guest/session":{"delete":{"tags":["guests"],"summary":"Delete Guest Session","description":"Delete guest session and all associated data","operationId":"delete_guest_session_guest_session_delete","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/guest/databases":{"get":{"tags":["guests"],"summary":"List Public Databases","description":"List public databases available to guests","operationId":"list_public_databases_guest_databases_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/guest/database/{database_name}/tables":{"get":{"tags":["guests"],"summary":"Get Database Tables Guest","description":"Get tables in database for guests","operationId":"get_database_tables_guest_guest_database__database_name__tables_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"database_name","in":"path","required":true,"schema":{"type":"string","title":"Database Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/guest/database/{database_name}/{table_name}/data":{"get":{"tags":["guests"],"summary":"Get Table Data Guest","description":"Get data from table for guests (limited)","operationId":"get_table_data_guest_guest_database__database_name___table_name__data_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"database_name","in":"path","required":true,"schema":{"type":"string","title":"Database Name"}},{"name":"table_name","in":"path","required":true,"schema":{"type":"string","title":"Table Name"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":5,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/guest/admin/guests":{"get":{"tags":["guests"],"summary":"Get All Guests","description":"Get all guest users (admin only - would need admin auth in production)","operationId":"get_all_guests_guest_admin_guests_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/guest/admin/cleanup":{"post":{"tags":["guests"],"summary":"Manual Cleanup Expired Guests","description":"Manually trigger cleanup of expired guests (admin only)","operationId":"manual_cleanup_expired_guests_guest_admin_cleanup_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/guest/admin/stats":{"get":{"tags":["guests"],"summary":"Get Guest Statistics","description":"Get guest user statistics (admin only)","operationId":"get_guest_statistics_guest_admin_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/admin/system/config":{"get":{"tags":["admin"],"summary":"Get System Config","description":"Get all system configurations","operationId":"get_system_config_admin_system_config_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]},"post":{"tags":["admin"],"summary":"Create System Config","description":"Create system configuration","operationId":"create_system_config_admin_system_config_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SystemConfigRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/admin/system/config/{config_id}":{"put":{"tags":["admin"],"summary":"Update System Config","description":"Update system configuration","operationId":"update_system_config_admin_system_config__config_id__put","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"config_id","in":"path","required":true,"schema":{"type":"integer","title":"Config Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Config Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["admin"],"summary":"Delete System Config","description":"Delete system configuration","operationId":"delete_system_config_admin_system_config__config_id__delete","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"config_id","in":"path","required":true,"schema":{"type":"integer","title":"Config Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/analytics/usage":{"get":{"tags":["admin"],"summary":"Get Usage Analytics","description":"Get detailed API usage analytics","operationId":"get_usage_analytics_admin_analytics_usage_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","default":30,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/analytics/performance":{"get":{"tags":["admin"],"summary":"Get Performance Analytics","description":"Get performance analytics","operationId":"get_performance_analytics_admin_analytics_performance_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"hours","in":"query","required":false,"schema":{"type":"integer","default":24,"title":"Hours"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/login-audit":{"get":{"tags":["admin"],"summary":"Get Login Audit","description":"Get login audit log for all users","operationId":"get_login_audit_admin_login_audit_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"user_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"User Id"}},{"name":"ip_address","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ip Address"}},{"name":"success_only","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Success Only"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","default":30,"title":"Days"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"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"}}}}}}},"/admin/login-stats":{"get":{"tags":["admin"],"summary":"Get Login Stats","description":"Get login statistics","operationId":"get_login_stats_admin_login_stats_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","default":30,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/broadcast":{"post":{"tags":["admin"],"summary":"Broadcast Message","description":"Send broadcast message to users","operationId":"broadcast_message_admin_broadcast_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BroadcastMessageRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/admin/maintenance/cleanup":{"post":{"tags":["admin"],"summary":"Run Maintenance Cleanup","description":"Run system maintenance and cleanup","operationId":"run_maintenance_cleanup_admin_maintenance_cleanup_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/admin/logs":{"get":{"tags":["admin"],"summary":"Get System Logs","description":"Get system logs (mock implementation)","operationId":"get_system_logs_admin_logs_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"lines","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Lines"}},{"name":"level","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Level"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/export/users":{"get":{"tags":["admin"],"summary":"Export Users Data","description":"Export users data","operationId":"export_users_data_admin_export_users_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"format","in":"query","required":false,"schema":{"type":"string","default":"json","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/export/usage":{"get":{"tags":["admin"],"summary":"Export Usage Data","description":"Export API usage data","operationId":"export_usage_data_admin_export_usage_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","default":30,"title":"Days"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","default":"json","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/health":{"get":{"tags":["admin"],"summary":"Admin System Health","description":"Check admin system health","operationId":"admin_system_health_admin_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/admin/users/simple":{"get":{"tags":["admin"],"summary":"Get All Users Simple","description":"Get all users' names and emails (simple list)","operationId":"get_all_users_simple_admin_users_simple_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/admin/users":{"get":{"tags":["admin"],"summary":"List All Users","description":"List all users with filtering and pagination","operationId":"list_all_users_admin_users_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"}},{"name":"account_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Type"}},{"name":"is_verified","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Verified"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["admin"],"summary":"Create User","description":"Create new user (admin only)","operationId":"create_user_admin_users_post","security":[{"APIKeyHeader":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserCreateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/users/{user_id}":{"get":{"tags":["admin"],"summary":"Get User Details","description":"Get detailed user information","operationId":"get_user_details_admin_users__user_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","title":"User Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["admin"],"summary":"Update User","description":"Update user information","operationId":"update_user_admin_users__user_id__put","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","title":"User Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["admin"],"summary":"Delete User","description":"Delete user account","operationId":"delete_user_admin_users__user_id__delete","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","title":"User Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/users/{user_id}/credits":{"post":{"tags":["admin"],"summary":"Adjust User Credits","description":"Adjust user credit balance","operationId":"adjust_user_credits_admin_users__user_id__credits_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","title":"User Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreditAdjustmentRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/users/{user_id}/reset-password":{"post":{"tags":["admin"],"summary":"Reset User Password","description":"Reset user password","operationId":"reset_user_password_admin_users__user_id__reset_password_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","title":"User Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Password Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/guests":{"get":{"tags":["admin"],"summary":"List Guest Users","description":"List all guest users","operationId":"list_guest_users_admin_guests_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"platform","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform"}},{"name":"is_active","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Active"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/guests/cleanup":{"post":{"tags":["admin"],"summary":"Cleanup Expired Guests Endpoint","description":"Manually cleanup expired guests","operationId":"cleanup_expired_guests_endpoint_admin_guests_cleanup_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/admin/guests/{guest_id}":{"delete":{"tags":["admin"],"summary":"Delete Guest User","description":"Delete specific guest user","operationId":"delete_guest_user_admin_guests__guest_id__delete","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"guest_id","in":"path","required":true,"schema":{"type":"integer","title":"Guest Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/databases":{"get":{"tags":["admin"],"summary":"List Databases","description":"List all databases in registry","operationId":"list_databases_admin_databases_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]},"post":{"tags":["admin"],"summary":"Create Database","description":"Create new database registry entry","operationId":"create_database_admin_databases_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseCreateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/admin/databases/{database_id}":{"put":{"tags":["admin"],"summary":"Update Database","description":"Update database registry entry","operationId":"update_database_admin_databases__database_id__put","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"database_id","in":"path","required":true,"schema":{"type":"integer","title":"Database Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Db Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/system/stats":{"get":{"tags":["admin"],"summary":"Get System Statistics","description":"Get comprehensive system statistics","operationId":"get_system_statistics_admin_system_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/cashfree/plans":{"get":{"tags":["payments"],"summary":"Get Plans","description":"Get all available subscription plans (USD only)\nPublic endpoint - no authentication required","operationId":"get_plans_cashfree_plans_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/cashfree/config":{"get":{"tags":["payments"],"summary":"Get Config","description":"Get Cashfree configuration and supported currencies","operationId":"get_config_cashfree_config_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/cashfree/create-order":{"post":{"tags":["payments"],"summary":"Create Order","description":"Create Cashfree payment order for subscription\n\nReference: https://www.cashfree.com/docs/api-reference/payments/latest/orders/create","operationId":"create_order_cashfree_create_order_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateOrderRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/cashfree/order/{order_id}":{"get":{"tags":["payments"],"summary":"Get Order Status","description":"Get Cashfree order status\n\nReference: https://www.cashfree.com/docs/api-reference/payments/latest/orders/get","operationId":"get_order_status_cashfree_order__order_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"string","title":"Order Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/cashfree/payments/{order_id}":{"get":{"tags":["payments"],"summary":"Get Order Payments","description":"Get all payment attempts for an order\n\nReference: https://www.cashfree.com/docs/api-reference/payments/latest/payments/get-payments-for-order","operationId":"get_order_payments_cashfree_payments__order_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"string","title":"Order Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/cashfree/checkout/{payment_session_id}":{"get":{"tags":["payments"],"summary":"Cashfree Embedded Checkout","description":"Professional embedded Cashfree Elements checkout page\nThis provides a white-label payment experience served directly from our FastAPI backend\nUses Cashfree.js SDK with embedded card payment components\n\nDocumentation: https://www.cashfree.com/docs/payments/online/element/overview","operationId":"cashfree_embedded_checkout_cashfree_checkout__payment_session_id__get","parameters":[{"name":"payment_session_id","in":"path","required":true,"schema":{"type":"string","title":"Payment Session Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/cashfree/webhook":{"post":{"tags":["payments"],"summary":"Handle Webhook","description":"Handle Cashfree payment webhook events\n\nReference: https://www.cashfree.com/docs/payments/online/webhooks\n\nEvents:\n- PAYMENT_SUCCESS_WEBHOOK\n- PAYMENT_FAILED_WEBHOOK\n- PAYMENT_USER_DROPPED_WEBHOOK","operationId":"handle_webhook_cashfree_webhook_post","parameters":[{"name":"x-webhook-timestamp","in":"header","required":false,"schema":{"type":"string","title":"X-Webhook-Timestamp"}},{"name":"x-webhook-signature","in":"header","required":false,"schema":{"type":"string","title":"X-Webhook-Signature"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/payment/plans":{"get":{"tags":["payments"],"summary":"Get Plans","description":"Get all available subscription plans (USD only)\nPublic endpoint - no authentication required","operationId":"get_plans_payment_plans_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/payment/config":{"get":{"tags":["payments"],"summary":"Get Config","description":"Get Cashfree configuration and supported currencies","operationId":"get_config_payment_config_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/payment/create-order":{"post":{"tags":["payments"],"summary":"Create Order","description":"Create Cashfree payment order for subscription\n\nReference: https://www.cashfree.com/docs/api-reference/payments/latest/orders/create","operationId":"create_order_payment_create_order_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateOrderRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/payment/order/{order_id}":{"get":{"tags":["payments"],"summary":"Get Order Status","description":"Get Cashfree order status\n\nReference: https://www.cashfree.com/docs/api-reference/payments/latest/orders/get","operationId":"get_order_status_payment_order__order_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"string","title":"Order Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/payment/payments/{order_id}":{"get":{"tags":["payments"],"summary":"Get Order Payments","description":"Get all payment attempts for an order\n\nReference: https://www.cashfree.com/docs/api-reference/payments/latest/payments/get-payments-for-order","operationId":"get_order_payments_payment_payments__order_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"string","title":"Order Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/payment/checkout/{payment_session_id}":{"get":{"tags":["payments"],"summary":"Cashfree Embedded Checkout","description":"Professional embedded Cashfree Elements checkout page\nThis provides a white-label payment experience served directly from our FastAPI backend\nUses Cashfree.js SDK with embedded card payment components\n\nDocumentation: https://www.cashfree.com/docs/payments/online/element/overview","operationId":"cashfree_embedded_checkout_payment_checkout__payment_session_id__get","parameters":[{"name":"payment_session_id","in":"path","required":true,"schema":{"type":"string","title":"Payment Session Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/payment/webhook":{"post":{"tags":["payments"],"summary":"Handle Webhook","description":"Handle Cashfree payment webhook events\n\nReference: https://www.cashfree.com/docs/payments/online/webhooks\n\nEvents:\n- PAYMENT_SUCCESS_WEBHOOK\n- PAYMENT_FAILED_WEBHOOK\n- PAYMENT_USER_DROPPED_WEBHOOK","operationId":"handle_webhook_payment_webhook_post","parameters":[{"name":"x-webhook-timestamp","in":"header","required":false,"schema":{"type":"string","title":"X-Webhook-Timestamp"}},{"name":"x-webhook-signature","in":"header","required":false,"schema":{"type":"string","title":"X-Webhook-Signature"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/news/single-domain/{domain}":{"get":{"tags":["news"],"summary":"Get News From Single Domain","description":"Get news from a single domain with 0.10 credit cost","operationId":"get_news_from_single_domain_news_single_domain__domain__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","title":"Domain"}},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/NewsCategory"},{"type":"null"}],"title":"Category"}},{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/news/multiple-domains":{"post":{"tags":["news"],"summary":"Get News From Multiple Domains","description":"Get news from multiple domains with 0.25 credit cost","operationId":"get_news_from_multiple_domains_news_multiple_domains_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/news/date-range":{"post":{"tags":["news"],"summary":"Get News By Date Range","description":"Get news within a specific date range with 0.15 credit cost","operationId":"get_news_by_date_range_news_date_range_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DateRangeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/news/country/{country_code}":{"get":{"tags":["news"],"summary":"Get News By Country","description":"Get news from a specific country with 0.12 credit cost","operationId":"get_news_by_country_news_country__country_code__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"country_code","in":"path","required":true,"schema":{"type":"string","title":"Country Code"}},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/NewsCategory"},{"type":"null"}],"title":"Category"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/news/topic-search":{"post":{"tags":["news"],"summary":"Search News By Topic","description":"Search news by keywords/topics with 0.12 credit cost","operationId":"search_news_by_topic_news_topic_search_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopicSearchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/news/categories":{"get":{"tags":["news"],"summary":"Get Available Categories","description":"Get list of available news categories (free endpoint)","operationId":"get_available_categories_news_categories_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/news/pricing":{"get":{"tags":["news"],"summary":"Get News Pricing","description":"Get credit costs for different news operations (free endpoint)","operationId":"get_news_pricing_news_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/news/stats":{"get":{"tags":["news"],"summary":"Get News Usage Stats","description":"Get user's news API usage statistics","operationId":"get_news_usage_stats_news_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/news/analyze":{"post":{"tags":["news"],"summary":"Analyze News Article","description":"AI-powered news article analysis\nExtracts article content and performs comprehensive financial analysis\nCost: 10 credits","operationId":"analyze_news_article_news_analyze_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewsAnalysisRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/support/tickets":{"get":{"tags":["support"],"summary":"Get User Tickets","description":"Get user's support tickets","operationId":"get_user_tickets_support_tickets_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]},"post":{"tags":["support"],"summary":"Create Ticket","description":"Create new support ticket (requires authentication)","operationId":"create_ticket_support_tickets_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TicketCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/support/tickets/{ticket_id}":{"get":{"tags":["support"],"summary":"Get Ticket Details","description":"Get detailed ticket information with messages","operationId":"get_ticket_details_support_tickets__ticket_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"ticket_id","in":"path","required":true,"schema":{"type":"integer","title":"Ticket Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["support"],"summary":"Update Ticket","description":"Update ticket status (user can only close/reopen)","operationId":"update_ticket_support_tickets__ticket_id__put","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"ticket_id","in":"path","required":true,"schema":{"type":"integer","title":"Ticket Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TicketUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/support/tickets/{ticket_id}/messages":{"post":{"tags":["support"],"summary":"Add Ticket Message","description":"Add message to support ticket","operationId":"add_ticket_message_support_tickets__ticket_id__messages_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"ticket_id","in":"path","required":true,"schema":{"type":"integer","title":"Ticket Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/support/contact":{"post":{"tags":["support"],"summary":"Submit Contact Form","description":"Submit contact form (public endpoint)","operationId":"submit_contact_form_support_contact_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactFormCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/support/feedback":{"post":{"tags":["support"],"summary":"Submit Feedback","description":"Submit feedback (public endpoint)","operationId":"submit_feedback_support_feedback_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedbackCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/support/categories":{"get":{"tags":["support"],"summary":"Get Support Categories","description":"Get available support categories (public endpoint)","operationId":"get_support_categories_support_categories_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/support/stats":{"get":{"tags":["support"],"summary":"Get Support Stats","description":"Get user's support statistics","operationId":"get_support_stats_support_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/support/newsletter/subscribe":{"post":{"tags":["support"],"summary":"Subscribe To Newsletter","description":"Subscribe to Fincept newsletter (public endpoint - no authentication required)","operationId":"subscribe_to_newsletter_support_newsletter_subscribe_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewsletterSubscribe"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/support/newsletter/unsubscribe":{"post":{"tags":["support"],"summary":"Unsubscribe From Newsletter","description":"Unsubscribe from newsletter (public endpoint)","operationId":"unsubscribe_from_newsletter_support_newsletter_unsubscribe_post","parameters":[{"name":"email","in":"query","required":true,"schema":{"type":"string","format":"email","title":"Email"}},{"name":"token","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/support/newsletter/status":{"get":{"tags":["support"],"summary":"Check Newsletter Status","description":"Check newsletter subscription status (public endpoint)","operationId":"check_newsletter_status_support_newsletter_status_get","parameters":[{"name":"email","in":"query","required":true,"schema":{"type":"string","format":"email","title":"Email"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/chat/sessions":{"get":{"tags":["chat"],"summary":"Get Chat Sessions","description":"Get user's chat sessions (both registered and guest users)","operationId":"get_chat_sessions_chat_sessions_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["chat"],"summary":"Create Chat Session","description":"Create new chat session","operationId":"create_chat_session_chat_sessions_post","security":[{"APIKeyHeader":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatSessionCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/chat/sessions/bulk-delete":{"delete":{"tags":["chat"],"summary":"Bulk Delete Sessions","description":"Bulk delete chat sessions (registered users only)","operationId":"bulk_delete_sessions_chat_sessions_bulk_delete_delete","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Session 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":[{"APIKeyHeader":[]}]}},"/chat/sessions/{session_uuid}":{"get":{"tags":["chat"],"summary":"Get Chat Session","description":"Get specific chat session with messages","operationId":"get_chat_session_chat_sessions__session_uuid__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"session_uuid","in":"path","required":true,"schema":{"type":"string","title":"Session Uuid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["chat"],"summary":"Delete Chat Session","description":"Delete chat session and all messages","operationId":"delete_chat_session_chat_sessions__session_uuid__delete","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"session_uuid","in":"path","required":true,"schema":{"type":"string","title":"Session Uuid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/chat/sessions/{session_uuid}/messages":{"post":{"tags":["chat"],"summary":"Send Chat Message","description":"Send message to chat session and get AI response","operationId":"send_chat_message_chat_sessions__session_uuid__messages_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"session_uuid","in":"path","required":true,"schema":{"type":"string","title":"Session Uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatMessageCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/chat/sessions/{session_uuid}/activate":{"put":{"tags":["chat"],"summary":"Activate Chat Session","description":"Activate a chat session (deactivates others)","operationId":"activate_chat_session_chat_sessions__session_uuid__activate_put","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"session_uuid","in":"path","required":true,"schema":{"type":"string","title":"Session Uuid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/chat/sessions/{session_uuid}/title":{"put":{"tags":["chat"],"summary":"Update Chat Title","description":"Update chat session title","operationId":"update_chat_title_chat_sessions__session_uuid__title_put","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"session_uuid","in":"path","required":true,"schema":{"type":"string","title":"Session Uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Title Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/chat/stats":{"get":{"tags":["chat"],"summary":"Get Chat Statistics","description":"Get chat statistics for current user","operationId":"get_chat_statistics_chat_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/chat/export":{"post":{"tags":["chat"],"summary":"Export Chat Sessions","description":"Export chat sessions to JSON (registered users only)","operationId":"export_chat_sessions_chat_export_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Export 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":[{"APIKeyHeader":[]}]}},"/chat/admin/statistics":{"get":{"tags":["chat"],"summary":"Get Admin Chat Statistics","description":"Get system-wide chat statistics (admin only)","operationId":"get_admin_chat_statistics_chat_admin_statistics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/chat/admin/sessions":{"get":{"tags":["chat"],"summary":"Get Admin Chat Sessions","description":"Get all chat sessions with pagination (admin only)","operationId":"get_admin_chat_sessions_chat_admin_sessions_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"user_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Type"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/chat/quick-chat":{"post":{"tags":["chat"],"summary":"Quick Chat","description":"Quick chat without session management (for testing)","operationId":"quick_chat_chat_quick_chat_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatMessageCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/chat/search":{"get":{"tags":["chat"],"summary":"Search Chat Messages","description":"Search chat messages","operationId":"search_chat_messages_chat_search_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string","title":"Query"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/chat/templates":{"get":{"tags":["chat"],"summary":"Get Chat Templates","description":"Get predefined chat templates (registered users only)","operationId":"get_chat_templates_chat_templates_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/chat/templates/{template_id}/start":{"post":{"tags":["chat"],"summary":"Start Template Session","description":"Start a chat session from template (registered users only)","operationId":"start_template_session_chat_templates__template_id__start_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"template_id","in":"path","required":true,"schema":{"type":"string","title":"Template Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/forum/categories":{"get":{"tags":["forum"],"summary":"Get Forum Categories","description":"Get all forum categories (accessible to both users and guests)","operationId":"get_forum_categories_forum_categories_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/forum/categories/{category_id}/posts":{"get":{"tags":["forum"],"summary":"Get Category Posts","description":"Get posts in a specific category","operationId":"get_category_posts_forum_categories__category_id__posts_get","parameters":[{"name":"category_id","in":"path","required":true,"schema":{"type":"integer","title":"Category Id"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":20,"title":"Limit"}},{"name":"sort_by","in":"query","required":false,"schema":{"type":"string","pattern":"^(latest|popular|views|replies)$","default":"latest","title":"Sort By"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["forum"],"summary":"Create Forum Post","description":"Create new forum post (registered users only)","operationId":"create_forum_post_forum_categories__category_id__posts_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"category_id","in":"path","required":true,"schema":{"type":"integer","title":"Category Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForumPostCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/forum/posts/trending":{"get":{"tags":["forum"],"summary":"Get Trending Posts","description":"Get trending forum posts","operationId":"get_trending_posts_forum_posts_trending_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":10,"title":"Limit"}},{"name":"timeframe","in":"query","required":false,"schema":{"type":"string","pattern":"^(day|week|month)$","default":"week","title":"Timeframe"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/forum/posts/{post_uuid}":{"get":{"tags":["forum"],"summary":"Get Forum Post","description":"Get specific forum post with comments","operationId":"get_forum_post_forum_posts__post_uuid__get","parameters":[{"name":"post_uuid","in":"path","required":true,"schema":{"type":"string","title":"Post Uuid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/forum/posts/{post_uuid}/comments":{"post":{"tags":["forum"],"summary":"Create Forum Comment","description":"Create comment on forum post (registered users only)","operationId":"create_forum_comment_forum_posts__post_uuid__comments_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"post_uuid","in":"path","required":true,"schema":{"type":"string","title":"Post Uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForumCommentCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/forum/posts/{post_uuid}/vote":{"post":{"tags":["forum"],"summary":"Vote On Post","description":"Vote on forum post (registered users only)","operationId":"vote_on_post_forum_posts__post_uuid__vote_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"post_uuid","in":"path","required":true,"schema":{"type":"string","title":"Post Uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForumVoteCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/forum/comments/{comment_uuid}/vote":{"post":{"tags":["forum"],"summary":"Vote On Comment","description":"Vote on forum comment (registered users only)","operationId":"vote_on_comment_forum_comments__comment_uuid__vote_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"comment_uuid","in":"path","required":true,"schema":{"type":"string","title":"Comment Uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForumVoteCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/forum/search":{"get":{"tags":["forum"],"summary":"Search Forum","description":"Search forum posts and comments","operationId":"search_forum_forum_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":100,"title":"Q"}},{"name":"category_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Category Id"}},{"name":"post_type","in":"query","required":false,"schema":{"type":"string","pattern":"^(all|posts|comments)$","default":"all","title":"Post Type"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/forum/stats":{"get":{"tags":["forum"],"summary":"Get Forum Statistics","description":"Get forum statistics","operationId":"get_forum_statistics_forum_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/forum/profile/{username}":{"get":{"tags":["forum"],"summary":"Get Forum User Profile","description":"Get forum user profile (registered users only)","operationId":"get_forum_user_profile_forum_profile__username__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"username","in":"path","required":true,"schema":{"type":"string","title":"Username"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/forum/profile":{"get":{"tags":["forum"],"summary":"Get My Forum Profile","description":"Get current user's forum profile","operationId":"get_my_forum_profile_forum_profile_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]},"put":{"tags":["forum"],"summary":"Update Forum Profile","description":"Update current user's forum profile","operationId":"update_forum_profile_forum_profile_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForumProfileUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/forum/admin/categories":{"post":{"tags":["forum"],"summary":"Create Forum Category","description":"Create new forum category (admin only)","operationId":"create_forum_category_forum_admin_categories_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Category 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":[{"APIKeyHeader":[]}]}},"/forum/admin/statistics":{"get":{"tags":["forum"],"summary":"Get Admin Forum Statistics","description":"Get detailed forum statistics (admin only)","operationId":"get_admin_forum_statistics_forum_admin_statistics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/marketplace/upload":{"post":{"tags":["marketplace"],"summary":"Upload Dataset","description":"Upload dataset to marketplace with pricing options","operationId":"upload_dataset_marketplace_upload_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"metadata","in":"query","required":true,"schema":{"type":"string","title":"Metadata"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_dataset_marketplace_upload_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/marketplace/datasets":{"get":{"tags":["marketplace"],"summary":"Browse Datasets","description":"Browse marketplace datasets (registered users only)","operationId":"browse_datasets_marketplace_datasets_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"}},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"}},{"name":"price_tier","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Price Tier"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Limit"}},{"name":"sort_by","in":"query","required":false,"schema":{"type":"string","default":"uploaded_at","title":"Sort By"}},{"name":"sort_order","in":"query","required":false,"schema":{"type":"string","default":"desc","title":"Sort Order"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/marketplace/my-purchases":{"get":{"tags":["marketplace"],"summary":"Get User Purchases","description":"Get user's dataset purchases","operationId":"get_user_purchases_marketplace_my_purchases_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/marketplace/pricing":{"get":{"tags":["marketplace"],"summary":"Get Pricing Tiers","description":"Get available pricing tiers for dataset uploads","operationId":"get_pricing_tiers_marketplace_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/marketplace/my-datasets":{"get":{"tags":["marketplace"],"summary":"Get My Datasets","description":"Get user's uploaded datasets with status filtering","operationId":"get_my_datasets_marketplace_my_datasets_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Limit"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/marketplace/datasets/{dataset_id}":{"patch":{"tags":["marketplace"],"summary":"Update Dataset","description":"Update dataset metadata (only owner can update, only if pending/rejected)","operationId":"update_dataset_marketplace_datasets__dataset_id__patch","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"dataset_id","in":"path","required":true,"schema":{"type":"integer","title":"Dataset Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Update Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["marketplace"],"summary":"Delete Dataset","description":"Delete dataset (only owner can delete, only if not purchased by others)","operationId":"delete_dataset_marketplace_datasets__dataset_id__delete","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"dataset_id","in":"path","required":true,"schema":{"type":"integer","title":"Dataset Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["marketplace"],"summary":"Get Dataset Details","description":"Get detailed dataset information","operationId":"get_dataset_details_marketplace_datasets__dataset_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"dataset_id","in":"path","required":true,"schema":{"type":"integer","title":"Dataset Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/marketplace/datasets/{dataset_id}/purchase":{"post":{"tags":["marketplace"],"summary":"Purchase Dataset","description":"Get free access to dataset (no payment required)","operationId":"purchase_dataset_marketplace_datasets__dataset_id__purchase_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"dataset_id","in":"path","required":true,"schema":{"type":"integer","title":"Dataset Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatasetPurchaseRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/marketplace/datasets/{dataset_id}/download":{"post":{"tags":["marketplace"],"summary":"Download Dataset","description":"Download dataset file (free for all registered users)","operationId":"download_dataset_marketplace_datasets__dataset_id__download_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"dataset_id","in":"path","required":true,"schema":{"type":"integer","title":"Dataset Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/marketplace/my-datasets/analytics":{"get":{"tags":["marketplace"],"summary":"Get Dataset Analytics","description":"Get analytics for user's uploaded datasets","operationId":"get_dataset_analytics_marketplace_my_datasets_analytics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/marketplace/admin/revenue-analytics":{"get":{"tags":["marketplace"],"summary":"Get Admin Revenue Analytics","description":"Get marketplace revenue analytics for admin","operationId":"get_admin_revenue_analytics_marketplace_admin_revenue_analytics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/marketplace/admin/stats":{"get":{"tags":["marketplace"],"summary":"Get Marketplace Stats","description":"Get comprehensive marketplace statistics","operationId":"get_marketplace_stats_marketplace_admin_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/marketplace/admin/pending-datasets":{"get":{"tags":["marketplace"],"summary":"Get Pending Datasets","description":"Get all pending datasets for approval","operationId":"get_pending_datasets_marketplace_admin_pending_datasets_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/marketplace/admin/datasets/{dataset_id}/approve":{"post":{"tags":["marketplace"],"summary":"Approve Dataset","description":"Approve a pending dataset","operationId":"approve_dataset_marketplace_admin_datasets__dataset_id__approve_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"dataset_id","in":"path","required":true,"schema":{"type":"integer","title":"Dataset Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/marketplace/admin/datasets/{dataset_id}/reject":{"post":{"tags":["marketplace"],"summary":"Reject Dataset","description":"Reject a pending dataset","operationId":"reject_dataset_marketplace_admin_datasets__dataset_id__reject_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"dataset_id","in":"path","required":true,"schema":{"type":"integer","title":"Dataset Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Rejection Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/research/papers/search":{"get":{"tags":["research","research"],"summary":"Search Papers","description":"Search academic papers from arXiv with pagination\nCost: 1 credit per 10 papers (per page)\nRate limit: 1 request per second\n\nReturns 10 papers per page. Each page costs 1 credit.\nExample: page=1 returns papers 1-10, page=2 returns papers 11-20","operationId":"search_papers_research_papers_search_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string","description":"Search query (keywords separated by space)","title":"Query"},"description":"Search query (keywords separated by space)"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number (1-indexed)","default":1,"title":"Page"},"description":"Page number (1-indexed)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/research/papers/trending":{"get":{"tags":["research","research"],"summary":"Get Trending Papers","description":"Get trending recent papers by topic with pagination\nCost: 1 credit per 10 papers (per page)\nRate limit: 1 request per second","operationId":"get_trending_papers_research_papers_trending_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"topic","in":"query","required":true,"schema":{"type":"string","description":"Research topic","title":"Topic"},"description":"Research topic"},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":7,"description":"Days to look back","default":30,"title":"Days"},"description":"Days to look back"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number","default":1,"title":"Page"},"description":"Page number"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/research/content-reader":{"post":{"tags":["research","research"],"summary":"Content Reader","description":"Extract and read content from web documents\nCost: 0.25 credits per request\nRate limit: 1 request per second","operationId":"content_reader_research_content_reader_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContentReaderRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/research/web-search":{"post":{"tags":["research","research"],"summary":"Web Search","description":"Search the web for financial and market intelligence","operationId":"web_search_research_web_search_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebSearchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/research/chat":{"post":{"tags":["research","research"],"summary":"Fincept Chat","description":"Official Fincept AI Chat","operationId":"fincept_chat_research_chat_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/research/grokipedia":{"post":{"tags":["research","research"],"summary":"Grokipedia Fetch","description":"Fetch knowledge articles from Grokipedia (xAI's knowledge base)\n\nThis endpoint retrieves comprehensive articles from Grokipedia, covering various topics\nwith detailed content, references, and citations.\n\nCost: 0.25 credits per request\nRate limit: 1 request per second\n\nParameters:\n- slug: Article slug/identifier (e.g., \"artificial-intelligence\", \"climate-change\")\n- extract_refs: Extract and include references (default: true)\n- truncate: Limit content to N characters (optional)\n- citations: Include citation formatting (default: false)\n\nExample slugs:\n- \"bitcoin\"\n- \"machine-learning\"\n- \"quantum-computing\"\n- \"financial-markets\"","operationId":"grokipedia_fetch_research_grokipedia_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GrokipediaRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/research/pdf/extract":{"post":{"tags":["research","research"],"summary":"Extract Pdf Text","description":"Extract text from uploaded PDF file\nDynamic Pricing:\n- 1-10 pages: 1 credit\n- 11-50 pages: 2 credits\n- 51-100 pages: 3 credits\n- 101-200 pages: 5 credits\n- 201+ pages: 10 credits\nRate limit: 1 request per second\nMax file size: 10MB","operationId":"extract_pdf_text_research_pdf_extract_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_extract_pdf_text_research_pdf_extract_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/research/health":{"get":{"tags":["research","research"],"summary":"Research Health","description":"Health check for Fincept research module","operationId":"research_health_research_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/research/llm":{"post":{"tags":["research","research"],"summary":"General Llm Inference","description":"General-purpose LLM endpoint for running agents, processing data, and AI tasks.\n\nThis endpoint allows you to use Fincept API as your LLM provider for:\n- Running AI agents\n- Data processing and analysis\n- Code generation\n- Text summarization\n- Question answering\n- Any other LLM-based tasks\n\nCost: 5 credits per successful response\nNote: Credits are ONLY deducted on successful LLM response. If the LLM fails, no credits are charged.\n\nRate limit: 1 request per second","operationId":"general_llm_inference_research_llm_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LLMRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/research/visual-analysis":{"post":{"tags":["research","research"],"summary":"Satellite Visual Analysis","description":"Multimodal Visual Analysis using GLM-4.6V for satellite imagery and visual understanding.\n\nThis endpoint enables advanced visual analysis capabilities including:\n- Satellite image analysis and interpretation\n- Geographic feature detection and classification\n- Land use and land cover analysis\n- Urban planning and infrastructure mapping\n- Environmental monitoring\n- Agricultural assessment\n- Disaster response and damage assessment\n- Object detection and counting in images\n- Visual question answering\n- Image description and captioning\n\nModel: GLM-4.6V (Multimodal Vision-Language Model)\n- Native multimodal understanding\n- 128K context window\n- Advanced visual reasoning\n- Function calling capabilities\n- High-resolution image processing\n\nCost: 10 credits per successful response\nNote: Credits are ONLY deducted on successful analysis. If the model fails, no credits are charged.\n\nRate limit: 1 request per second\n\nExample Use Cases:\n- \"Identify all buildings in this satellite image\"\n- \"What type of land use is shown in this area?\"\n- \"Detect any changes or anomalies in this image\"\n- \"Count the number of vehicles in this parking lot\"\n- \"Analyze the vegetation health in this agricultural field\"","operationId":"satellite_visual_analysis_research_visual_analysis_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VisualAnalysisRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/marine/vessel/position":{"post":{"tags":["marine","marine"],"summary":"Get Vessel Position","description":"Get last known position of a vessel by IMO\nCost: 1 credit per request","operationId":"get_vessel_position_marine_vessel_position_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VesselPositionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/marine/vessel/history":{"post":{"tags":["marine","marine"],"summary":"Get Vessel History","description":"Get complete historical location data for a vessel\nCost: 5 credits per request","operationId":"get_vessel_history_marine_vessel_history_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VesselPositionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/marine/vessel/multi":{"post":{"tags":["marine","marine"],"summary":"Get Multi Vessel Positions","description":"Get last known positions for multiple vessels (max 50)\nCost: 3 credits per request","operationId":"get_multi_vessel_positions_marine_vessel_multi_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MultiVesselRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/marine/vessel/area-search":{"post":{"tags":["marine","marine"],"summary":"Search Vessels In Area","description":"Search for all vessels in a defined geographic area\nCost: 8 credits per request\n\nParameters:\n- min_lat, max_lat, min_lng, max_lng: Geographic boundary\n- days_ago (optional): Get historical data from N days ago (0-365)\n If not provided or 0, returns current/latest positions","operationId":"search_vessels_in_area_marine_vessel_area_search_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AreaSearchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/marine/health":{"get":{"tags":["marine","marine"],"summary":"Marine Health","description":"Health check for marine module","operationId":"marine_health_marine_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/aircraft/health":{"get":{"tags":["aircraft","aircraft"],"summary":"Aircraft Health","description":"Health check for aircraft tracking module","operationId":"aircraft_health_aircraft_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/aircraft/track":{"post":{"tags":["aircraft","aircraft"],"summary":"Track Aircraft","description":"Track aircraft by ID using PlaneFinder API with Selenium\nCost: 0.25 credits per successful request\nRate limit: 1 request per second","operationId":"track_aircraft_aircraft_track_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AircraftRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/aircraft/{aircraft_id}":{"get":{"tags":["aircraft","aircraft"],"summary":"Get Aircraft Endpoint","description":"Get aircraft data by ID (raw format)\nSimple endpoint without authentication for testing","operationId":"get_aircraft_endpoint_aircraft__aircraft_id__get","parameters":[{"name":"aircraft_id","in":"path","required":true,"schema":{"type":"string","title":"Aircraft Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/aircraft/{aircraft_id}/raw":{"get":{"tags":["aircraft","aircraft"],"summary":"Get Aircraft Raw","description":"Get raw aircraft data by ID\nSimple endpoint without authentication for testing","operationId":"get_aircraft_raw_aircraft__aircraft_id__raw_get","parameters":[{"name":"aircraft_id","in":"path","required":true,"schema":{"type":"string","title":"Aircraft Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/health":{"get":{"tags":["twitter","twitter"],"summary":"Twitter Health","description":"Health check for Twitter integration module","operationId":"twitter_health_twitter_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/twitter/countries":{"get":{"tags":["twitter","twitter"],"summary":"Get Available Countries","description":"Get list of all available countries for Twitter trends\nNo authentication required","operationId":"get_available_countries_twitter_countries_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/twitter/trends":{"get":{"tags":["twitter","twitter"],"summary":"Get Twitter Trends","description":"Get current Twitter trending topics for a country\n\nParameters:\n- country: Country name (optional, default: \"worldwide\")\n Examples: \"india\", \"usa\", \"uk\", \"japan\", \"brazil\", \"france\", etc.\n Use /twitter/countries to see all available countries\n\nCost: 0.5 credits per request\nRate limit: 1 request per 2 seconds","operationId":"get_twitter_trends_twitter_trends_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/user/tweets":{"get":{"tags":["twitter","twitter"],"summary":"Get User Tweets","description":"Get user's latest tweets (up to 20 per request)\n\nParameters:\n- username: Twitter screen name (e.g., \"elonmusk\")\n- user_id: Twitter user ID (recommended, more stable than username)\n- cursor: Pagination cursor for next page\n\nNote: Either username OR user_id is required. If both provided, user_id takes priority.\n\nCost: 1.0 credit per request (returns up to 20 tweets)\nRate limit: 1 request per 2 seconds\n\nReturns tweets sorted by created_at with pagination support.","operationId":"get_user_tweets_twitter_user_tweets_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"username","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Username"}},{"name":"user_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/tweets":{"get":{"tags":["twitter","twitter"],"summary":"Get Tweets By Ids","description":"Get tweets by their IDs\n\nParameters:\n- tweet_ids: Comma-separated tweet IDs (e.g., \"1846987139428634858,1866332309399781537\")\n\nCost: 0.5 credits per request\nRate limit: 1 request per 2 seconds\n\nReturns tweet data for the specified IDs.","operationId":"get_tweets_by_ids_twitter_tweets_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"tweet_ids","in":"query","required":true,"schema":{"type":"string","title":"Tweet Ids"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/tweet/replies":{"get":{"tags":["twitter","twitter"],"summary":"Get Tweet Replies","description":"Get replies to a tweet (up to 20 per request)\n\nParameters:\n- tweet_id: The tweet ID to get replies for (required)\n- since_time: On or after specified unix timestamp in seconds (optional)\n- until_time: Before specified unix timestamp in seconds (optional)\n- cursor: Pagination cursor for next page (optional)\n\nNote: tweet_id must be an original tweet (not a reply to another tweet)\n and should be the first tweet in a thread.\n\nCost: 1.0 credit per request (returns up to 20 replies)\nRate limit: 1 request per 2 seconds\n\nReturns replies sorted by reply time (descending) with pagination support.","operationId":"get_tweet_replies_twitter_tweet_replies_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"tweet_id","in":"query","required":true,"schema":{"type":"string","title":"Tweet Id"}},{"name":"since_time","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Since Time"}},{"name":"until_time","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Until Time"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/tweet/quotes":{"get":{"tags":["twitter","twitter"],"summary":"Get Tweet Quotes","description":"Get quote tweets of a tweet (20 quotes per request)\n\nParameters:\n- tweet_id: The tweet ID to get quotes for (required)\n- since_time: On or after specified unix timestamp in seconds (optional)\n- until_time: Before specified unix timestamp in seconds (optional)\n- include_replies: Include replies in results (default: true)\n- cursor: Pagination cursor for next page (optional)\n\nCost: 1.0 credit per request (returns 20 quotes)\nRate limit: 1 request per 2 seconds\n\nReturns quote tweets sorted by quote time (descending) with pagination support.","operationId":"get_tweet_quotes_twitter_tweet_quotes_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"tweet_id","in":"query","required":true,"schema":{"type":"string","title":"Tweet Id"}},{"name":"since_time","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Since Time"}},{"name":"until_time","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Until Time"}},{"name":"include_replies","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Include Replies"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/tweet/retweeters":{"get":{"tags":["twitter","twitter"],"summary":"Get Tweet Retweeters","description":"Get users who retweeted a tweet (~100 users per request)\n\nParameters:\n- tweet_id: The tweet ID to get retweeters for (required)\n- cursor: Pagination cursor for next page (optional)\n\nCost: 1.5 credits per request (returns ~100 users)\nRate limit: 1 request per 2 seconds\n\nReturns users who retweeted the tweet, sorted by retweet time (descending) with pagination support.","operationId":"get_tweet_retweeters_twitter_tweet_retweeters_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"tweet_id","in":"query","required":true,"schema":{"type":"string","title":"Tweet Id"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/article":{"get":{"tags":["twitter","twitter"],"summary":"Get Twitter Article","description":"Get full article content from a Twitter article tweet\n\n PREMIUM ENDPOINT - Costs 100 credits per article!\n\nParameters:\n- tweet_id: The tweet ID of the article (required)\n\nCost: 100 credits per article (PREMIUM)\nRate limit: 1 request per 2 seconds\n\nReturns full article content including title, preview, cover image, and full text.\nThis is a premium endpoint due to the comprehensive article data provided.","operationId":"get_twitter_article_twitter_article_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"tweet_id","in":"query","required":true,"schema":{"type":"string","title":"Tweet Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/tweet/thread_context":{"get":{"tags":["twitter","twitter"],"summary":"Get Tweet Thread Context","description":"Get the full thread context of a tweet\n\nThis endpoint retrieves the entire conversation thread containing the specified tweet.\nFor example, if a thread has tweets t1 -> t2 -> t3 -> t4, t5, t6 (all replying to t3),\nproviding t3 will return the entire thread: t1, t2, t3, t4, t5, t6.\n\nParameters:\n- tweet_id: The tweet ID (can be a reply or original tweet)\n- cursor: Pagination cursor for next page (optional)\n\nNote: Pagination size varies due to Twitter API limitations.\nThe number of tweets per page is not fixed.\n\nCost: 2.0 credits per request (variable tweets per page)\nRate limit: 1 request per 2 seconds\n\nReturns the full thread context with pagination support.","operationId":"get_tweet_thread_context_twitter_tweet_thread_context_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"tweet_id","in":"query","required":true,"schema":{"type":"string","title":"Tweet Id"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/tweet/advanced_search":{"get":{"tags":["twitter","twitter"],"summary":"Advanced Tweet Search","description":"Advanced search for tweets with powerful query syntax\n\nSupports advanced Twitter search operators for precise tweet discovery.\n\nParameters:\n- query: Search query with advanced operators (required)\n Examples:\n - \"AI\" OR \"Twitter\" from:elonmusk since:2021-12-31_23:59:59_UTC\n - \"#bitcoin\" min_faves:100\n - \"python\" filter:verified\n See: https://github.com/igorbrigadir/twitter-advanced-search\n\n- query_type: \"Latest\" (chronological) or \"Top\" (most relevant)\n- cursor: Pagination cursor for next page (optional)\n\nCost: 2.5 credits per request (up to 20 tweets)\nRate limit: 1 request per 2 seconds\n\nReturns search results with pagination support.","operationId":"advanced_tweet_search_twitter_tweet_advanced_search_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string","title":"Query"}},{"name":"query_type","in":"query","required":false,"schema":{"type":"string","default":"Latest","title":"Query Type"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/user/search":{"get":{"tags":["twitter","twitter"],"summary":"Search Users","description":"Search for Twitter users by keyword\n\nParameters:\n- query: Search keyword (required)\n- cursor: Pagination cursor for next page (optional)\n\nCost: 1.5 credits per request\nRate limit: 1 request per 2 seconds\n\nReturns matching users with pagination support.","operationId":"search_users_twitter_user_search_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string","title":"Query"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/user/mentions":{"get":{"tags":["twitter","twitter"],"summary":"Get User Mentions","description":"Get tweet mentions by user screen name\nEach page returns exactly 20 mentions\nOrder by mention time descending\nCost: 1.0 credit per request\nRate limit: 1 request per 2 seconds","operationId":"get_user_mentions_twitter_user_mentions_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"userName","in":"query","required":true,"schema":{"type":"string","title":"Username"}},{"name":"sinceTime","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sincetime"}},{"name":"untilTime","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Untiltime"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/analytics/my-login-history":{"get":{"tags":["analytics"],"summary":"Get My Login History","description":"Get current user's login history (User only sees their own)","operationId":"get_my_login_history_analytics_my_login_history_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"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"}}}}}}},"/analytics/admin/dashboard":{"get":{"tags":["analytics"],"summary":"Get Admin Dashboard","description":"Get comprehensive dashboard statistics (Admin only)","operationId":"get_admin_dashboard_analytics_admin_dashboard_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/analytics/admin/users/growth":{"get":{"tags":["analytics"],"summary":"Get User Growth","description":"Get user growth analytics (Admin only)","operationId":"get_user_growth_analytics_admin_users_growth_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/analytics/admin/engagement":{"get":{"tags":["analytics"],"summary":"Get Engagement Metrics","description":"Get user engagement metrics (Admin only)","operationId":"get_engagement_metrics_analytics_admin_engagement_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/analytics/admin/api-stats":{"get":{"tags":["analytics"],"summary":"Get Api Statistics","description":"Get API usage statistics (Admin only)","operationId":"get_api_statistics_analytics_admin_api_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/analytics/admin/usage":{"get":{"tags":["analytics"],"summary":"Get Usage Analytics","description":"Get detailed API usage analytics (Admin only)","operationId":"get_usage_analytics_analytics_admin_usage_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","default":30,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/analytics/admin/performance":{"get":{"tags":["analytics"],"summary":"Get Performance Analytics","description":"Get performance analytics (Admin only)","operationId":"get_performance_analytics_analytics_admin_performance_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"hours","in":"query","required":false,"schema":{"type":"integer","default":24,"title":"Hours"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/analytics/admin/login-audit":{"get":{"tags":["analytics"],"summary":"Get Login Audit","description":"Get login audit log for all users (Admin only)","operationId":"get_login_audit_analytics_admin_login_audit_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"user_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"User Id"}},{"name":"ip_address","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ip Address"}},{"name":"success_only","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Success Only"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","default":30,"title":"Days"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"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"}}}}}}},"/analytics/admin/revenue-analytics":{"get":{"tags":["analytics"],"summary":"Get Admin Revenue Analytics","description":"Get marketplace revenue analytics (Admin only)","operationId":"get_admin_revenue_analytics_analytics_admin_revenue_analytics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/analytics/admin/subscription-analytics":{"get":{"tags":["analytics"],"summary":"Get Subscription Analytics","description":"Get subscription analytics (Admin only) - DISABLED - Payment system to be reimplemented","operationId":"get_subscription_analytics_analytics_admin_subscription_analytics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/speech/decompose":{"post":{"tags":["speech"],"summary":"Decompose Speech","description":"Decompose financial/political speech into structured components.\n\n- Requires API key authentication\n- Costs 2-10 credits based on text size\n- Maximum text length: 500,000 characters\n- Processing is done asynchronously for long texts (>10K chars)\n\nCredit tiers:\n- <5K chars: 2 credits\n- <15K chars: 3 credits\n- <30K chars: 4 credits\n- <50K chars: 5 credits\n- <100K chars: 6 credits\n- <200K chars: 8 credits\n- 200K+ chars: 10 credits","operationId":"decompose_speech_speech_decompose_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SpeechInput"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/speech/status/{analysis_id}":{"get":{"tags":["speech"],"summary":"Get Analysis Status","description":"Get status of a speech analysis (user can only access their own)","operationId":"get_analysis_status_speech_status__analysis_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"analysis_id","in":"path","required":true,"schema":{"type":"string","title":"Analysis Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/speech/history":{"get":{"tags":["speech"],"summary":"Get Analysis History","description":"Get user's speech analysis history","operationId":"get_analysis_history_speech_history_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"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"}}}}}}},"/speech/result/{analysis_id}":{"get":{"tags":["speech"],"summary":"Get Full Result","description":"Get full decomposition result including raw passes (user's own only)","operationId":"get_full_result_speech_result__analysis_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"analysis_id","in":"path","required":true,"schema":{"type":"string","title":"Analysis Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trade/countries":{"get":{"tags":["trade"],"summary":"Get Countries","description":"Get list of countries with optional filtering\n\n- continent: Filter by continent ID (af, as, eu, na, sa, oc)\n- search: Search country name","operationId":"get_countries_trade_countries_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"continent","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Continent"}},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trade/continents":{"get":{"tags":["trade"],"summary":"Get Continents","description":"Get list of all continents","operationId":"get_continents_trade_continents_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/trade/products":{"get":{"tags":["trade"],"summary":"Get Products","description":"Get product hierarchy\n\n- level: Filter by level (Section, HS2, HS4, HS6)\n- parent: Get children of parent HS code","operationId":"get_products_trade_products_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"level","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Level"}},{"name":"parent","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trade/bilateral":{"get":{"tags":["trade"],"summary":"Get Bilateral Trade","description":"Get bilateral trade data between countries\n\nReturns trade flows between exporters and importers for a specific product and year","operationId":"get_bilateral_trade_trade_bilateral_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"hs_code","in":"query","required":true,"schema":{"type":"string","description":"HS product code","title":"Hs Code"},"description":"HS product code"},{"name":"year","in":"query","required":true,"schema":{"type":"integer","description":"Year (1995-2023)","title":"Year"},"description":"Year (1995-2023)"},{"name":"exporter","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Exporter country ID","title":"Exporter"},"description":"Exporter country ID"},{"name":"importer","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Importer country ID","title":"Importer"},"description":"Importer country ID"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trade/country-partners/{country_id}":{"get":{"tags":["trade"],"summary":"Get Country Trade Partners","description":"Get top trading partners for a country (for Chord Diagram)\n\nReturns ranked list of trading partners with trade values","operationId":"get_country_trade_partners_trade_country_partners__country_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"country_id","in":"path","required":true,"schema":{"type":"string","title":"Country Id"}},{"name":"year","in":"query","required":true,"schema":{"type":"integer","description":"Year (1995-2023)","title":"Year"},"description":"Year (1995-2023)"},{"name":"hs_code","in":"query","required":false,"schema":{"type":"string","description":"HS product code","default":"1","title":"Hs Code"},"description":"HS product code"},{"name":"flow_type","in":"query","required":false,"schema":{"type":"string","description":"export, import, or total","default":"total","title":"Flow Type"},"description":"export, import, or total"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trade/chord-data/{country_id}":{"get":{"tags":["trade"],"summary":"Get Chord Diagram Data","description":"Get data formatted for Chord Diagram visualization (like Bloomberg Terminal)\n\nReturns:\n- nodes: List of countries (source + top partners)\n- flows: Trade flows between countries\n- rankings: Ranked list of partners with total trade","operationId":"get_chord_diagram_data_trade_chord_data__country_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"country_id","in":"path","required":true,"schema":{"type":"string","title":"Country Id"}},{"name":"year","in":"query","required":false,"schema":{"type":"integer","description":"Year (1995-2023)","default":2017,"title":"Year"},"description":"Year (1995-2023)"},{"name":"hs_code","in":"query","required":false,"schema":{"type":"string","description":"HS product code","default":"1","title":"Hs Code"},"description":"HS product code"},{"name":"top_n","in":"query","required":false,"schema":{"type":"integer","maximum":50,"description":"Number of top partners","default":15,"title":"Top N"},"description":"Number of top partners"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trade/time-series/{country_id}":{"get":{"tags":["trade"],"summary":"Get Trade Time Series","description":"Get time series trade data for a country\n\nReturns trade values over time for trend analysis","operationId":"get_trade_time_series_trade_time_series__country_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"country_id","in":"path","required":true,"schema":{"type":"string","title":"Country Id"}},{"name":"hs_code","in":"query","required":false,"schema":{"type":"string","description":"HS product code","default":"1","title":"Hs Code"},"description":"HS product code"},{"name":"start_year","in":"query","required":false,"schema":{"type":"integer","default":1995,"title":"Start Year"}},{"name":"end_year","in":"query","required":false,"schema":{"type":"integer","default":2023,"title":"End Year"}},{"name":"flow","in":"query","required":false,"schema":{"type":"string","description":"export, import, or both","default":"both","title":"Flow"},"description":"export, import, or both"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trade/growth/{country_id}":{"get":{"tags":["trade"],"summary":"Get Trade Growth","description":"Get trade growth rates for a country","operationId":"get_trade_growth_trade_growth__country_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"country_id","in":"path","required":true,"schema":{"type":"string","title":"Country Id"}},{"name":"hs_code","in":"query","required":false,"schema":{"type":"string","description":"HS product code","default":"1","title":"Hs Code"},"description":"HS product code"},{"name":"year","in":"query","required":false,"schema":{"type":"integer","default":2023,"title":"Year"}},{"name":"flow","in":"query","required":false,"schema":{"type":"string","description":"export or import","default":"export","title":"Flow"},"description":"export or import"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trade/balance/{country_id}":{"get":{"tags":["trade"],"summary":"Get Trade Balance","description":"Get trade balance (surplus/deficit) for a country","operationId":"get_trade_balance_trade_balance__country_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"country_id","in":"path","required":true,"schema":{"type":"string","title":"Country Id"}},{"name":"hs_code","in":"query","required":false,"schema":{"type":"string","description":"HS product code","default":"1","title":"Hs Code"},"description":"HS product code"},{"name":"year","in":"query","required":false,"schema":{"type":"integer","default":2023,"title":"Year"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trade/top-exporters":{"get":{"tags":["trade"],"summary":"Get Top Exporters","description":"Get top exporting countries for a product","operationId":"get_top_exporters_trade_top_exporters_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"hs_code","in":"query","required":false,"schema":{"type":"string","description":"HS product code","default":"1","title":"Hs Code"},"description":"HS product code"},{"name":"year","in":"query","required":false,"schema":{"type":"integer","default":2023,"title":"Year"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trade/top-importers":{"get":{"tags":["trade"],"summary":"Get Top Importers","description":"Get top importing countries for a product","operationId":"get_top_importers_trade_top_importers_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"hs_code","in":"query","required":false,"schema":{"type":"string","description":"HS product code","default":"1","title":"Hs Code"},"description":"HS product code"},{"name":"year","in":"query","required":false,"schema":{"type":"integer","default":2023,"title":"Year"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trade/continent-trade":{"get":{"tags":["trade"],"summary":"Get Continent Trade","description":"Get trade by continent","operationId":"get_continent_trade_trade_continent_trade_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"hs_code","in":"query","required":false,"schema":{"type":"string","description":"HS product code","default":"1","title":"Hs Code"},"description":"HS product code"},{"name":"year","in":"query","required":false,"schema":{"type":"integer","default":2023,"title":"Year"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trade/health":{"get":{"tags":["trade"],"summary":"Health Check","description":"Health check for trade analytics API","operationId":"health_check_trade_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/":{"get":{"summary":"Root","description":"API status endpoint","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health":{"get":{"summary":"Health Check","description":"System health check","operationId":"health_check_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/auth/status":{"get":{"summary":"Auth Status","description":"Check authentication status","operationId":"auth_status_auth_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/test":{"get":{"summary":"Test Endpoint","description":"Test endpoint","operationId":"test_endpoint_test_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/mcp/sync":{"post":{"summary":"Manual Mcp Sync","description":"Manually trigger MCP scripts sync from GitHub (Admin only)\n\nArgs:\n force: Force sync even if not time yet (default False)","operationId":"manual_mcp_sync_mcp_sync_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"force","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Force"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/mcp/status":{"get":{"summary":"Mcp Status","description":"Get MCP system status (tools available, last sync, etc.)","operationId":"mcp_status_mcp_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"AircraftRequest":{"properties":{"aircraft_id":{"type":"string","title":"Aircraft Id"}},"type":"object","required":["aircraft_id"],"title":"AircraftRequest"},"AreaSearchRequest":{"properties":{"min_lat":{"type":"number","title":"Min Lat"},"max_lat":{"type":"number","title":"Max Lat"},"min_lng":{"type":"number","title":"Min Lng"},"max_lng":{"type":"number","title":"Max Lng"},"days_ago":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Days Ago"}},"type":"object","required":["min_lat","max_lat","min_lng","max_lng"],"title":"AreaSearchRequest"},"Body_extract_pdf_text_research_pdf_extract_post":{"properties":{"file":{"type":"string","format":"binary","title":"File","description":"PDF file to process"}},"type":"object","required":["file"],"title":"Body_extract_pdf_text_research_pdf_extract_post"},"Body_upload_dataset_marketplace_upload_post":{"properties":{"file":{"type":"string","format":"binary","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_dataset_marketplace_upload_post"},"BroadcastMessageRequest":{"properties":{"subject":{"type":"string","title":"Subject"},"message":{"type":"string","title":"Message"},"target_users":{"type":"string","title":"Target Users","default":"all"}},"type":"object","required":["subject","message"],"title":"BroadcastMessageRequest"},"ChatMessageCreate":{"properties":{"content":{"type":"string","title":"Content"}},"type":"object","required":["content"],"title":"ChatMessageCreate"},"ChatRequest":{"properties":{"messages":{"items":{},"type":"array","title":"Messages"},"model":{"type":"string","title":"Model","default":"meituan/longcat-flash-chat:free"}},"type":"object","required":["messages"],"title":"ChatRequest"},"ChatSessionCreate":{"properties":{"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":"New Conversation"}},"type":"object","title":"ChatSessionCreate"},"ContactFormCreate":{"properties":{"name":{"type":"string","title":"Name"},"email":{"type":"string","format":"email","title":"Email"},"subject":{"type":"string","title":"Subject"},"message":{"type":"string","title":"Message"}},"type":"object","required":["name","email","subject","message"],"title":"ContactFormCreate"},"ContentReaderRequest":{"properties":{"url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Url"},"format":{"type":"string","title":"Format","default":"markdown"}},"type":"object","required":["url"],"title":"ContentReaderRequest"},"CreateOrderRequest":{"properties":{"plan_id":{"type":"string","title":"Plan Id"},"currency":{"type":"string","title":"Currency","default":"USD"},"return_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Return Url"}},"type":"object","required":["plan_id"],"title":"CreateOrderRequest","description":"Request model for creating Cashfree payment order"},"CreditAdjustmentRequest":{"properties":{"action":{"type":"string","title":"Action"},"amount":{"type":"integer","title":"Amount"},"reason":{"type":"string","title":"Reason","default":"Admin adjustment"}},"type":"object","required":["action","amount"],"title":"CreditAdjustmentRequest"},"DatabaseCreateRequest":{"properties":{"database_name":{"type":"string","title":"Database Name"},"display_name":{"type":"string","title":"Display Name"},"description":{"type":"string","title":"Description","default":""},"category":{"type":"string","title":"Category","default":"general"},"is_public":{"type":"boolean","title":"Is Public","default":false},"requires_subscription":{"type":"boolean","title":"Requires Subscription","default":true},"cost_per_request":{"type":"integer","title":"Cost Per Request","default":20},"free_tier_limit":{"type":"integer","title":"Free Tier Limit","default":10},"total_tables":{"type":"integer","title":"Total Tables","default":0}},"type":"object","required":["database_name","display_name"],"title":"DatabaseCreateRequest"},"DatabaseSubscriptionRequest":{"properties":{"database_name":{"type":"string","title":"Database Name"}},"type":"object","required":["database_name"],"title":"DatabaseSubscriptionRequest"},"DatasetPurchaseRequest":{"properties":{"payment_method":{"type":"string","title":"Payment Method","default":"subscription_credit"}},"type":"object","title":"DatasetPurchaseRequest"},"DateRangeRequest":{"properties":{"start_date":{"type":"string","format":"date-time","title":"Start Date"},"end_date":{"type":"string","format":"date-time","title":"End Date"},"domains":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Domains"},"category":{"anyOf":[{"$ref":"#/components/schemas/NewsCategory"},{"type":"null"}]},"limit":{"type":"integer","title":"Limit","default":10}},"type":"object","required":["start_date","end_date"],"title":"DateRangeRequest"},"DeviceRegistration":{"properties":{"device_id":{"type":"string","title":"Device Id"},"device_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Device Name"},"platform":{"type":"string","title":"Platform"},"hardware_info":{"additionalProperties":true,"type":"object","title":"Hardware Info"}},"type":"object","required":["device_id","platform","hardware_info"],"title":"DeviceRegistration"},"FeedbackCreate":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"email":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}],"title":"Email"},"rating":{"type":"integer","title":"Rating"},"feedback_text":{"type":"string","title":"Feedback Text"},"category":{"type":"string","title":"Category","default":"general"}},"type":"object","required":["rating","feedback_text"],"title":"FeedbackCreate"},"ForumCommentCreate":{"properties":{"content":{"type":"string","title":"Content"},"parent_comment_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Parent Comment Id"}},"type":"object","required":["content"],"title":"ForumCommentCreate"},"ForumPostCreate":{"properties":{"title":{"type":"string","title":"Title"},"content":{"type":"string","title":"Content"},"category_id":{"type":"integer","title":"Category Id"}},"type":"object","required":["title","content","category_id"],"title":"ForumPostCreate"},"ForumProfileUpdate":{"properties":{"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"bio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bio"},"avatar_color":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Color"},"signature":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signature"},"show_email":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Show Email"},"email_notifications":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Email Notifications"}},"type":"object","title":"ForumProfileUpdate"},"ForumVoteCreate":{"properties":{"vote_type":{"type":"string","title":"Vote Type"}},"type":"object","required":["vote_type"],"title":"ForumVoteCreate"},"GrokipediaRequest":{"properties":{"slug":{"type":"string","title":"Slug"},"extract_refs":{"type":"boolean","title":"Extract Refs","default":true},"truncate":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Truncate"},"citations":{"type":"boolean","title":"Citations","default":false}},"type":"object","required":["slug"],"title":"GrokipediaRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"LLMRequest":{"properties":{"prompt":{"type":"string","title":"Prompt"},"max_tokens":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Tokens","default":4096},"temperature":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Temperature","default":0.7}},"type":"object","required":["prompt"],"title":"LLMRequest"},"MessageCreate":{"properties":{"message":{"type":"string","title":"Message"}},"type":"object","required":["message"],"title":"MessageCreate"},"MultiVesselRequest":{"properties":{"imos":{"items":{"type":"string"},"type":"array","title":"Imos"}},"type":"object","required":["imos"],"title":"MultiVesselRequest"},"NewsAnalysisRequest":{"properties":{"url":{"type":"string","title":"Url"}},"type":"object","required":["url"],"title":"NewsAnalysisRequest"},"NewsCategory":{"type":"string","enum":["business","technology","sports","entertainment","health","science","politics","world","local"],"title":"NewsCategory"},"NewsRequest":{"properties":{"domains":{"items":{"type":"string"},"type":"array","title":"Domains"},"category":{"anyOf":[{"$ref":"#/components/schemas/NewsCategory"},{"type":"null"}]},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language","default":"en"},"limit":{"type":"integer","title":"Limit","default":10}},"type":"object","required":["domains"],"title":"NewsRequest"},"NewsletterSubscribe":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source","default":"website"}},"type":"object","required":["email"],"title":"NewsletterSubscribe"},"OTPVerification":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"otp":{"type":"string","title":"Otp"}},"type":"object","required":["email","otp"],"title":"OTPVerification"},"PasswordReset":{"properties":{"email":{"type":"string","format":"email","title":"Email"}},"type":"object","required":["email"],"title":"PasswordReset"},"PasswordResetConfirm":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"otp":{"type":"string","title":"Otp"},"new_password":{"type":"string","title":"New Password"}},"type":"object","required":["email","otp","new_password"],"title":"PasswordResetConfirm"},"SpeechInput":{"properties":{"text":{"type":"string","maxLength":500000,"minLength":50,"title":"Text","description":"Raw speech text (50-500K chars)"}},"type":"object","required":["text"],"title":"SpeechInput"},"SystemConfigRequest":{"properties":{"config_key":{"type":"string","title":"Config Key"},"config_value":{"type":"string","title":"Config Value"},"config_type":{"type":"string","title":"Config Type","default":"string"},"description":{"type":"string","title":"Description","default":""}},"type":"object","required":["config_key","config_value"],"title":"SystemConfigRequest"},"TicketCreate":{"properties":{"subject":{"type":"string","title":"Subject"},"description":{"type":"string","title":"Description"},"category":{"type":"string","title":"Category"},"priority":{"type":"string","title":"Priority","default":"medium"}},"type":"object","required":["subject","description","category"],"title":"TicketCreate"},"TicketUpdate":{"properties":{"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},"type":"object","title":"TicketUpdate"},"TopicSearchRequest":{"properties":{"keywords":{"items":{"type":"string"},"type":"array","title":"Keywords"},"domains":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Domains"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"limit":{"type":"integer","title":"Limit","default":10}},"type":"object","required":["keywords"],"title":"TopicSearchRequest"},"UserCreateRequest":{"properties":{"username":{"type":"string","title":"Username"},"email":{"type":"string","format":"email","title":"Email"},"password":{"type":"string","title":"Password"},"account_type":{"type":"string","title":"Account Type","default":"free"},"is_admin":{"type":"boolean","title":"Is Admin","default":false},"is_verified":{"type":"boolean","title":"Is Verified","default":true},"credit_balance":{"type":"integer","title":"Credit Balance","default":0}},"type":"object","required":["username","email","password"],"title":"UserCreateRequest"},"UserLogin":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"password":{"type":"string","title":"Password"}},"type":"object","required":["email","password"],"title":"UserLogin"},"UserRegistration":{"properties":{"username":{"type":"string","title":"Username"},"email":{"type":"string","format":"email","title":"Email"},"password":{"type":"string","title":"Password"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code"}},"type":"object","required":["username","email","password"],"title":"UserRegistration"},"UserUpdateRequest":{"properties":{"username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Username"},"email":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}],"title":"Email"},"account_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Type"},"is_verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Verified"},"is_admin":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Admin"},"credit_balance":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Credit Balance"}},"type":"object","title":"UserUpdateRequest"},"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"},"VesselPositionRequest":{"properties":{"imo":{"type":"string","title":"Imo"}},"type":"object","required":["imo"],"title":"VesselPositionRequest"},"VisualAnalysisRequest":{"properties":{"image_url":{"type":"string","title":"Image Url"},"prompt":{"type":"string","title":"Prompt"},"max_tokens":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Tokens","default":4096},"temperature":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Temperature","default":0.7},"enable_thinking":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enable Thinking","default":false}},"type":"object","required":["image_url","prompt"],"title":"VisualAnalysisRequest"},"WebSearchRequest":{"properties":{"query":{"type":"string","title":"Query"},"engine":{"type":"string","title":"Engine","default":"google"}},"type":"object","required":["query"],"title":"WebSearchRequest"}},"securitySchemes":{"APIKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key"}}}}
\ No newline at end of file