{ "openapi": "3.1.0", "info": { "title": "PINNY Platform API", "version": "0.1.0" }, "paths": { "/auth/wallet-login": { "post": { "tags": [ "Authentication" ], "summary": "Wallet Login", "operationId": "wallet_login_auth_wallet_login_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WalletLoginRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Token" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/auth/signup": { "post": { "tags": [ "Authentication" ], "summary": "Signup", "operationId": "signup_auth_signup_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserCreate" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserProfile" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/auth/login": { "post": { "tags": [ "Authentication" ], "summary": "Login", "operationId": "login_auth_login_post", "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/Body_login_auth_login_post" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Token" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/auth/forgot-password": { "post": { "tags": [ "Authentication" ], "summary": "Forgot Password", "operationId": "forgot_password_auth_forgot_password_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ForgotPasswordRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ForgotPasswordResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/auth/reset-password": { "post": { "tags": [ "Authentication" ], "summary": "Reset Password", "operationId": "reset_password_auth_reset_password_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResetPasswordRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/auth/session": { "get": { "tags": [ "Authentication" ], "summary": "Get Session", "description": "Session endpoint for NextAuth compatibility.\nReturns user details and expiry.", "operationId": "get_session_auth_session_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/auth/me": { "get": { "tags": [ "Authentication" ], "summary": "Read Users Me", "description": "Get current user profile.\nSince get_current_user now fetches fresh data from DB, we can just return it.", "operationId": "read_users_me_auth_me_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserProfile" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/auth/logout": { "post": { "tags": [ "Authentication" ], "summary": "Logout", "operationId": "logout_auth_logout_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/auth/features": { "get": { "tags": [ "Authentication" ], "summary": "Get Auth Features", "description": "Returns feature access flags for the current user based on roles and Pinny Pro tier.\nCentralizes gating using shared.permissions.", "operationId": "get_auth_features_auth_features_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FeaturesResponse" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/auth/refresh": { "post": { "tags": [ "Authentication" ], "summary": "Refresh Token", "description": "Re-emite un access_token corto basado en el estado fresco del usuario.\n- No usa refresh tokens separados (simplificado). El token v\u00e1lido actual es suficiente para pedir refresh.\n- Sincroniza roles y verificaci\u00f3n desde DB mediante get_current_user.", "operationId": "refresh_token_auth_refresh_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RefreshResponse" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/profiles/me": { "get": { "tags": [ "Profiles" ], "summary": "Get My Profile", "operationId": "get_my_profile_profiles_me_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserProfile" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] }, "put": { "tags": [ "Profiles" ], "summary": "Update My Profile", "operationId": "update_my_profile_profiles_me_put", "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Payload" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserProfile" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/profiles/me/location": { "put": { "tags": [ "Profiles" ], "summary": "Update Location", "operationId": "update_location_profiles_me_location_put", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GeoLocation" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserProfile" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/profiles/me/assistant": { "put": { "tags": [ "Profiles" ], "summary": "Update Assistant Settings", "description": "Update PinnyPro Assistant settings.", "operationId": "update_assistant_settings_profiles_me_assistant_put", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AssistantSettings" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserProfile" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/profiles/me/security": { "put": { "tags": [ "Profiles" ], "summary": "Update Security Settings", "operationId": "update_security_settings_profiles_me_security_put", "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Payload" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserProfile" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/profiles/{user_id}/follow": { "post": { "tags": [ "Profiles" ], "summary": "Follow User", "description": "Follow a user.", "operationId": "follow_user_profiles__user_id__follow_post", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "user_id", "in": "path", "required": true, "schema": { "type": "string", "title": "User Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "Profiles" ], "summary": "Unfollow User", "description": "Unfollow a user.", "operationId": "unfollow_user_profiles__user_id__follow_delete", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "user_id", "in": "path", "required": true, "schema": { "type": "string", "title": "User Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/profiles/{user_id}/followers": { "get": { "tags": [ "Profiles" ], "summary": "Get Followers", "description": "Get list of followers for a user.", "operationId": "get_followers_profiles__user_id__followers_get", "parameters": [ { "name": "user_id", "in": "path", "required": true, "schema": { "type": "string", "title": "User Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/profiles/me/avatar": { "post": { "tags": [ "Profiles" ], "summary": "Upload Avatar", "operationId": "upload_avatar_profiles_me_avatar_post", "requestBody": { "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/Body_upload_avatar_profiles_me_avatar_post" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Upload Avatar Profiles Me Avatar Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/profiles/me/banner": { "post": { "tags": [ "Profiles" ], "summary": "Upload Banner", "operationId": "upload_banner_profiles_me_banner_post", "requestBody": { "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/Body_upload_banner_profiles_me_banner_post" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Upload Banner Profiles Me Banner Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/profiles/nearby": { "get": { "tags": [ "Profiles" ], "summary": "Get Nearby Profiles", "description": "Get profiles near a specific location using Meilisearch Geo-Search.", "operationId": "get_nearby_profiles_profiles_nearby_get", "parameters": [ { "name": "lat", "in": "query", "required": true, "schema": { "type": "number", "title": "Lat" } }, { "name": "lng", "in": "query", "required": true, "schema": { "type": "number", "title": "Lng" } }, { "name": "radius_km", "in": "query", "required": false, "schema": { "type": "number", "default": 50.0, "title": "Radius Km" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 10, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/UserProfile" }, "title": "Response Get Nearby Profiles Profiles Nearby Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/profiles/": { "get": { "tags": [ "Profiles" ], "summary": "Get Profiles", "description": "Get user profiles by role and type", "operationId": "get_profiles_profiles__get", "parameters": [ { "name": "role", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Role" } }, { "name": "profile_type", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Profile Type" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 20, "title": "Limit" } }, { "name": "skip", "in": "query", "required": false, "schema": { "type": "integer", "default": 0, "title": "Skip" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/UserProfile" }, "title": "Response Get Profiles Profiles Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/profiles/me/capabilities": { "put": { "tags": [ "Profiles" ], "summary": "Update Capabilities", "description": "Update capability flags for the current user and sync search index.", "operationId": "update_capabilities_profiles_me_capabilities_put", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Capabilities" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserProfile" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/profiles/me/offers": { "post": { "tags": [ "Profiles" ], "summary": "Create Offer", "description": "Create a new offer for the current user.", "operationId": "create_offer_profiles_me_offers_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Offer" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserProfile" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/profiles/me/offers/{offer_id}": { "put": { "tags": [ "Profiles" ], "summary": "Update Offer", "description": "Update an existing offer by ID for the current user.", "operationId": "update_offer_profiles_me_offers__offer_id__put", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "offer_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Offer Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Offer" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserProfile" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "Profiles" ], "summary": "Delete Offer", "description": "Delete an offer by ID for the current user.", "operationId": "delete_offer_profiles_me_offers__offer_id__delete", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "offer_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Offer Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserProfile" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/profiles/me/wishlist": { "get": { "tags": [ "Profiles" ], "summary": "Get My Wishlist", "description": "Get the current user's wishlist.", "operationId": "get_my_wishlist_profiles_me_wishlist_get", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "populate", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Populate" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/profiles/username/{username}": { "get": { "tags": [ "Profiles" ], "summary": "Get Profile By Username", "description": "Fetches a profile by username for public funnels.", "operationId": "get_profile_by_username_profiles_username__username__get", "parameters": [ { "name": "username", "in": "path", "required": true, "schema": { "type": "string", "title": "Username" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserProfile" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/profiles/matches": { "get": { "tags": [ "Profiles" ], "summary": "Get Matches", "description": "Find matching profiles based on user preferences, location, and boosted status.\nIf no user_id or current_user is provided, returns trending/boosted profiles.", "operationId": "get_matches_profiles_matches_get", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "user_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "The ID of the user to match for", "title": "User Id" }, "description": "The ID of the user to match for" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 20, "minimum": 1, "default": 4, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/profiles/{user_id}": { "get": { "tags": [ "Profiles" ], "summary": "Get Profile By Id", "description": "Get public profile by ID (increments profile views for non-owner/anonymous).", "operationId": "get_profile_by_id_profiles__user_id__get", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "user_id", "in": "path", "required": true, "schema": { "type": "string", "title": "User Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserProfile" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/profiles/roles": { "post": { "tags": [ "Profiles" ], "summary": "Add Role", "description": "Add a new role to the current user (Self-Upgrade)", "operationId": "add_role_profiles_roles_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RoleUpdate" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserProfile" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/profiles/me/modules/toggle": { "post": { "tags": [ "Profiles" ], "summary": "Toggle Module", "description": "Toggle activation state of experience modules (Unified Architecture).", "operationId": "toggle_module_profiles_me_modules_toggle_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ModuleToggleRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserProfile" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/profiles/verification": { "post": { "tags": [ "Profiles" ], "summary": "Request Verification", "description": "Submit identity verification documents.", "operationId": "request_verification_profiles_verification_post", "requestBody": { "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/Body_request_verification_profiles_verification_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": [ { "OAuth2PasswordBearer": [] } ] } }, "/profiles/{user_id}/wishlist": { "post": { "tags": [ "Profiles" ], "summary": "Toggle Wishlist", "description": "Toggle a user in the current user's wishlist (Redirect to stash).", "operationId": "toggle_wishlist_profiles__user_id__wishlist_post", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "user_id", "in": "path", "required": true, "schema": { "type": "string", "title": "User Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/profiles/boost": { "post": { "tags": [ "Profiles" ], "summary": "Boost Profile", "description": "Boost a profile for a specified duration using Pinny Credits.", "operationId": "boost_profile_profiles_boost_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BoostRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/profiles/me/gallery": { "get": { "tags": [ "Profiles" ], "summary": "Get My Gallery", "description": "Get all images in the current user's gallery.", "operationId": "get_my_gallery_profiles_me_gallery_get", "security": [ { "OAuth2PasswordBearer": [] } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "string" }, "title": "Response Get My Gallery Profiles Me Gallery Get" } } } } } }, "post": { "tags": [ "Profiles" ], "summary": "Upload Gallery Image", "description": "Upload an image to the profile gallery.", "operationId": "upload_gallery_image_profiles_me_gallery_post", "security": [ { "OAuth2PasswordBearer": [] } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/Body_upload_gallery_image_profiles_me_gallery_post" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Upload Gallery Image Profiles Me Gallery Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "Profiles" ], "summary": "Delete Gallery Image", "description": "Remove an image from the profile gallery.", "operationId": "delete_gallery_image_profiles_me_gallery_delete", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "url", "in": "query", "required": true, "schema": { "type": "string", "description": "The URL of the image to delete", "title": "Url" }, "description": "The URL of the image to delete" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/safety/timers": { "post": { "tags": [ "Safety Buddy" ], "summary": "Create Safety Timer", "description": "Starts a new safety timer.", "operationId": "create_safety_timer_safety_timers_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SafetyTimerCreate" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SafetyTimerResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/safety/timers/check-in": { "post": { "tags": [ "Safety Buddy" ], "summary": "Check In", "description": "Stops the active safety timer (User is safe).", "operationId": "check_in_safety_timers_check_in_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/safety/timers/active": { "get": { "tags": [ "Safety Buddy" ], "summary": "Get Active Timer", "description": "Fetches the current active safety timer.", "operationId": "get_active_timer_safety_timers_active_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/SafetyTimerResponse" }, { "type": "null" } ], "title": "Response Get Active Timer Safety Timers Active Get" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/lovense/sync-state": { "get": { "tags": [ "Lovense Integration" ], "summary": "Get Sync State", "description": "Fetches the current Lovense sync state for the creator.", "operationId": "get_sync_state_lovense_sync_state_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/lovense/generate-qr": { "post": { "tags": [ "Lovense Integration" ], "summary": "Generate Qr", "description": "Generates a Lovense sync QR code.", "operationId": "generate_qr_lovense_generate_qr_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/lovense/callback": { "post": { "tags": [ "Lovense Integration" ], "summary": "Lovense Callback", "description": "Webhook callback from Lovense when a device is connected.", "operationId": "lovense_callback_lovense_callback_post", "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Data" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/media-health/summary": { "get": { "tags": [ "Media Health" ], "summary": "Get Media Health Summary", "description": "Aggregate technical health and performance metrics for a creator's media.", "operationId": "get_media_health_summary_media_health_summary_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/seo-metrics/summary": { "get": { "tags": [ "Premium SEO" ], "summary": "Get Seo Metrics Summary", "description": "Fetch comprehensive SEO health and visibility metrics for a creator's profile.", "operationId": "get_seo_metrics_summary_seo_metrics_summary_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/fan-intelligence/summary": { "get": { "tags": [ "Fan Intelligence" ], "summary": "Get Fan Intelligence Summary", "description": "Returns high-level fan intelligence for a creator.", "operationId": "get_fan_intelligence_summary_fan_intelligence_summary_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/fan-intelligence/top-fans": { "get": { "tags": [ "Fan Intelligence" ], "summary": "Get Top Fans", "description": "Returns the creator's top 10 most loyal/engaged fans.", "operationId": "get_top_fans_fan_intelligence_top_fans_get", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "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" } } } } } } }, "/fan-intelligence/churn-prediction": { "get": { "tags": [ "Fan Intelligence" ], "summary": "Get Churn Prediction", "description": "AI-Powered Churn Prediction for fans.\nIdentifies fans likely to drop off.", "operationId": "get_churn_prediction_fan_intelligence_churn_prediction_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/touring/my-tours": { "get": { "tags": [ "Tour Manager" ], "summary": "Get My Tours", "description": "Fetch current and upcoming tours for the creator.", "operationId": "get_my_tours_touring_my_tours_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/touring/schedule": { "post": { "tags": [ "Tour Manager" ], "summary": "Schedule Tour", "description": "Schedule a new tour.", "operationId": "schedule_tour_touring_schedule_post", "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Tour 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": [ { "OAuth2PasswordBearer": [] } ] } }, "/touring/demand-prediction": { "get": { "tags": [ "Tour Manager" ], "summary": "Get Tour Demand Prediction", "description": "AI-Powered Demand Prediction for a specific city.\nUses scraper data (Orus) and platform activity.", "operationId": "get_tour_demand_prediction_touring_demand_prediction_get", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "city", "in": "query", "required": true, "schema": { "type": "string", "title": "City" } }, { "name": "country", "in": "query", "required": true, "schema": { "type": "string", "title": "Country" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/touring/{tour_id}": { "delete": { "tags": [ "Tour Manager" ], "summary": "Delete Tour", "description": "Cancel a scheduled tour.", "operationId": "delete_tour_touring__tour_id__delete", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "tour_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Tour Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/risk-management/security-events": { "get": { "tags": [ "Fraud & Risk" ], "summary": "Get Security Events", "description": "Admin tool to view security-related events (Failed logins, IP changes, etc.)", "operationId": "get_security_events_risk_management_security_events_get", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 50, "title": "Limit" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "default": 0, "title": "Offset" } }, { "name": "severity", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Severity" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/risk-management/user-reputation/{user_id}": { "get": { "tags": [ "Fraud & Risk" ], "summary": "Get User Reputation", "description": "Analyze a user's security reputation and device fingerprinting.", "operationId": "get_user_reputation_risk_management_user_reputation__user_id__get", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "user_id", "in": "path", "required": true, "schema": { "type": "string", "title": "User Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/risk-management/ban-user/{user_id}": { "post": { "tags": [ "Fraud & Risk" ], "summary": "Ban User", "description": "Ban a user for fraud or policy violations.", "operationId": "ban_user_risk_management_ban_user__user_id__post", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "user_id", "in": "path", "required": true, "schema": { "type": "string", "title": "User Id" } }, { "name": "reason", "in": "query", "required": true, "schema": { "type": "string", "title": "Reason" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/gamification/my-progress": { "get": { "tags": [ "Gamification & Rewards" ], "summary": "Get Gamification Progress", "description": "Fetch user's current level, XP, and badges.", "operationId": "get_gamification_progress_gamification_my_progress_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/gamification/achievements": { "get": { "tags": [ "Gamification & Rewards" ], "summary": "Get Available Achievements", "description": "Fetch available achievements and progress towards them.", "operationId": "get_available_achievements_gamification_achievements_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/gamification/claim-daily-spin": { "post": { "tags": [ "Gamification & Rewards" ], "summary": "Claim Daily Spin", "description": "Claim a daily XP bonus via a 'spin' mechanic.", "operationId": "claim_daily_spin_gamification_claim_daily_spin_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/custom-requests/submit": { "post": { "tags": [ "Custom Requests" ], "summary": "Submit Custom Request", "description": "Submit a new custom content request to a creator.", "operationId": "submit_custom_request_custom_requests_submit_post", "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Request 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": [ { "OAuth2PasswordBearer": [] } ] } }, "/custom-requests/my-requests": { "get": { "tags": [ "Custom Requests" ], "summary": "Get My Requests", "description": "Fetch custom requests sent by the current user.", "operationId": "get_my_requests_custom_requests_my_requests_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/custom-requests/creator-inbox": { "get": { "tags": [ "Custom Requests" ], "summary": "Get Creator Requests", "description": "Fetch custom requests received by the creator.", "operationId": "get_creator_requests_custom_requests_creator_inbox_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/custom-requests/{request_id}/action": { "post": { "tags": [ "Custom Requests" ], "summary": "Update Request Status", "description": "Creator action on a custom request.", "operationId": "update_request_status_custom_requests__request_id__action_post", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "request_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Request Id" } }, { "name": "action", "in": "query", "required": true, "schema": { "type": "string", "pattern": "^(ACCEPT|REJECT|DELIVER)$", "title": "Action" } }, { "name": "content", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Content" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/custom-requests/{request_id}/confirm": { "post": { "tags": [ "Custom Requests" ], "summary": "Confirm Delivery", "description": "Client confirms delivery of custom request, releasing funds to creator.", "operationId": "confirm_delivery_custom_requests__request_id__confirm_post", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "request_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Request Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/market-sentiment/suggestion": { "get": { "tags": [ "Market Sentiment" ], "summary": "Get Latest Suggestion", "description": "Fetch the latest price optimization suggestion from the Premium Economist.", "operationId": "get_latest_suggestion_market_sentiment_suggestion_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/market-sentiment/settings": { "post": { "tags": [ "Market Sentiment" ], "summary": "Update Sentiment Settings", "description": "Enable or disable autonomous price optimization suggestions.", "operationId": "update_sentiment_settings_market_sentiment_settings_post", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "enabled", "in": "query", "required": true, "schema": { "type": "boolean", "title": "Enabled" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/market-sentiment/apply": { "post": { "tags": [ "Market Sentiment" ], "summary": "Apply Suggested Price", "description": "Apply a suggested price to a specific category.", "operationId": "apply_suggested_price_market_sentiment_apply_post", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "category", "in": "query", "required": true, "schema": { "type": "string", "pattern": "^(video_call|chat|subscription|product)$", "title": "Category" } }, { "name": "price", "in": "query", "required": true, "schema": { "type": "number", "title": "Price" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/market-sentiment/market-rates": { "get": { "tags": [ "Market Sentiment" ], "summary": "Get Market Rates", "description": "Get anonymized market rates for a category/city to show benchmarks.", "operationId": "get_market_rates_market_sentiment_market_rates_get", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "category", "in": "query", "required": false, "schema": { "type": "string", "default": "video_call", "title": "Category" } }, { "name": "city", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "City" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/discovery/swipe": { "post": { "tags": [ "Discovery & Swiping" ], "summary": "Record Swipe", "description": "Record a swipe event for discovery analytics.", "operationId": "record_swipe_discovery_swipe_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SwipeEvent" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/discovery/analytics/swipes": { "get": { "tags": [ "Discovery & Swiping" ], "summary": "Get Swipe Analytics", "description": "Get discovery analytics for a creator.", "operationId": "get_swipe_analytics_discovery_analytics_swipes_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/reviews/": { "post": { "tags": [ "Reviews" ], "summary": "Create Review", "description": "Create a new review for a profile (Escort, Creator, etc.).", "operationId": "create_review_reviews__post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReviewCreate" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Review" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/reviews/{target_id}": { "get": { "tags": [ "Reviews" ], "summary": "Get Reviews", "description": "Get all reviews for a specific profile with pagination.", "operationId": "get_reviews_reviews__target_id__get", "parameters": [ { "name": "target_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Target Id" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 10, "title": "Limit" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "default": 0, "title": "Offset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/Review" }, "title": "Response Get Reviews Reviews Target Id Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/products/upload/image": { "post": { "tags": [ "Products / Stash" ], "summary": "Upload Image", "description": "Upload an image to S3/MinIO, optimized to WebP", "operationId": "upload_image_products_upload_image_post", "requestBody": { "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/Body_upload_image_products_upload_image_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": [ { "OAuth2PasswordBearer": [] } ] } }, "/products/upload/video": { "post": { "tags": [ "Products / Stash" ], "summary": "Upload Video", "description": "Upload a video to S3/MinIO, optimized for storage", "operationId": "upload_video_products_upload_video_post", "requestBody": { "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/Body_upload_video_products_upload_video_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": [ { "OAuth2PasswordBearer": [] } ] } }, "/products/": { "post": { "tags": [ "Products / Stash" ], "summary": "Create Product", "description": "Create a new product in the stash with optional file upload and Authorship Anchoring", "operationId": "create_product_products__post", "security": [ { "OAuth2PasswordBearer": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductCreate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Product" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "Products / Stash" ], "summary": "Get Products", "description": "Get list of products", "operationId": "get_products_products__get", "parameters": [ { "name": "provider_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Provider Id" } }, { "name": "type", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Type" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 20, "title": "Limit" } }, { "name": "skip", "in": "query", "required": false, "schema": { "type": "integer", "default": 0, "title": "Skip" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/Product" }, "title": "Response Get Products Products Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/products/{product_id}": { "get": { "tags": [ "Products / Stash" ], "summary": "Get Product", "description": "Get a single product", "operationId": "get_product_products__product_id__get", "parameters": [ { "name": "product_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Product Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Product" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "put": { "tags": [ "Products / Stash" ], "summary": "Update Product", "description": "Update a product", "operationId": "update_product_products__product_id__put", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "product_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Product Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductCreate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Product" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "Products / Stash" ], "summary": "Delete Product", "description": "Delete a product", "operationId": "delete_product_products__product_id__delete", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "product_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Product Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/products/{product_id}/purchase": { "post": { "tags": [ "Products / Stash" ], "summary": "Purchase Product", "description": "Purchase or unlock a product. \nSupports bundle deals for multiple quantities.", "operationId": "purchase_product_products__product_id__purchase_post", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "product_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Product Id" } }, { "name": "quantity", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "default": 1, "title": "Quantity" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/products/store/orders": { "get": { "tags": [ "Products / Stash" ], "summary": "Get Store Orders", "description": "Get orders where the current user is the seller (for creators) or buyer (for clients)", "operationId": "get_store_orders_products_store_orders_get", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "default": 20, "title": "Limit" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "default": 0, "title": "Offset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/StoreOrder" }, "title": "Response Get Store Orders Products Store Orders Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/products/store/orders/{order_id}": { "get": { "tags": [ "Products / Stash" ], "summary": "Get Store Order", "description": "Get a single order detail", "operationId": "get_store_order_products_store_orders__order_id__get", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "order_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Order Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StoreOrder" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/products/store/orders/{order_id}/status": { "put": { "tags": [ "Products / Stash" ], "summary": "Update Store Order Status", "description": "Update order status. Only the seller or admin can do this.", "operationId": "update_store_order_status_products_store_orders__order_id__status_put", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "order_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Order Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StoreOrderStatusUpdate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StoreOrder" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/dashboard/revenue/history": { "get": { "tags": [ "Dashboard" ], "summary": "Get Revenue History", "description": "Get daily revenue history from bookings and transactions.\nAggregates completed bookings and earnings-related transactions.", "operationId": "get_revenue_history_dashboard_revenue_history_get", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "days", "in": "query", "required": false, "schema": { "type": "integer", "default": 30, "title": "Days" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/RevenueDataPoint" }, "title": "Response Get Revenue History Dashboard Revenue History Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/dashboard/stats": { "get": { "tags": [ "Dashboard" ], "summary": "Get Dashboard Stats", "description": "Get consolidated dashboard statistics for the main view.", "operationId": "get_dashboard_stats_dashboard_stats_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DashboardStatsResponse" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/dashboard/global/stats": { "get": { "tags": [ "Dashboard" ], "summary": "Get Global Stats", "description": "Get public global statistics for the landing page.", "operationId": "get_global_stats_dashboard_global_stats_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GlobalStatsResponse" } } } } } } }, "/dashboard/widgets": { "get": { "tags": [ "Dashboard" ], "summary": "Get Dashboard Widgets", "description": "Get dynamic dashboard widgets based on User Role and PinnyPro Tier.", "operationId": "get_dashboard_widgets_dashboard_widgets_get", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "lat", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Lat" } }, { "name": "lng", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Lng" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DashboardResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/reels/upload": { "post": { "tags": [ "Reels" ], "summary": "Upload Reel", "description": "Upload a short vertical video (Reel)", "operationId": "upload_reel_reels_upload_post", "requestBody": { "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/Body_upload_reel_reels_upload_post" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Reel" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/reels/feed": { "get": { "tags": [ "Reels" ], "summary": "Get Reels Feed", "description": "Get Reels Feed with sorting options and access control.", "operationId": "get_reels_feed_reels_feed_get", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 10, "title": "Limit" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "default": 0, "title": "Offset" } }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string", "description": "Sort order: trending, newest, verified", "default": "trending", "title": "Sort" }, "description": "Sort order: trending, newest, verified" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/Reel" }, "title": "Response Get Reels Feed Reels Feed Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/reels/{reel_id}": { "put": { "tags": [ "Reels" ], "summary": "Update Reel", "description": "Update Reel metadata (Caption/Tags)", "operationId": "update_reel_reels__reel_id__put", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "reel_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Reel Id" } } ], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/Body_update_reel_reels__reel_id__put" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Reel" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "Reels" ], "summary": "Get Reel", "description": "Get a single reel by ID with access control", "operationId": "get_reel_reels__reel_id__get", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "reel_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Reel Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Reel" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "Reels" ], "summary": "Delete Reel", "description": "Delete a Reel and update user status if necessary", "operationId": "delete_reel_reels__reel_id__delete", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "reel_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Reel Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/reels/creator/{user_id}": { "get": { "tags": [ "Reels" ], "summary": "Get Creator Reels", "description": "Get all reels for a specific creator.\nHandles subscription-only (exclusive) content visibility.", "operationId": "get_creator_reels_reels_creator__user_id__get", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "user_id", "in": "path", "required": true, "schema": { "type": "string", "title": "User Id" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 50, "title": "Limit" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "default": 0, "title": "Offset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/Reel" }, "title": "Response Get Creator Reels Reels Creator User Id Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/reels/{reel_id}/like": { "post": { "tags": [ "Reels" ], "summary": "Like Reel", "operationId": "like_reel_reels__reel_id__like_post", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "reel_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Reel Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/reels/{reel_id}/view": { "post": { "tags": [ "Reels" ], "summary": "View Reel", "operationId": "view_reel_reels__reel_id__view_post", "parameters": [ { "name": "reel_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Reel Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/reels/{reel_id}/boost": { "post": { "tags": [ "Reels" ], "summary": "Boost Reel", "description": "Boost a Reel using Pinny Credits.\nCost: 5 Credits / 24h (Example)", "operationId": "boost_reel_reels__reel_id__boost_post", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "reel_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Reel Id" } }, { "name": "duration_hours", "in": "query", "required": false, "schema": { "type": "integer", "default": 24, "title": "Duration Hours" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/reels/{reel_id}/save": { "post": { "tags": [ "Reels" ], "summary": "Save Reel", "description": "Save a reel to the user's saved list", "operationId": "save_reel_reels__reel_id__save_post", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "reel_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Reel Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "Reels" ], "summary": "Unsave Reel", "operationId": "unsave_reel_reels__reel_id__save_delete", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "reel_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Reel Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/reels/saved": { "get": { "tags": [ "Reels" ], "summary": "Get Saved Reels", "description": "Get all reels saved by the current user", "operationId": "get_saved_reels_reels_saved_get", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 10, "title": "Limit" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "default": 0, "title": "Offset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/Reel" }, "title": "Response Get Saved Reels Reels Saved Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/drive/status": { "get": { "tags": [ "Pinny Drive" ], "summary": "Get Drive Status", "description": "Get current storage usage and limits", "operationId": "get_drive_status_drive_status_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/drive/save/{media_id}": { "post": { "tags": [ "Pinny Drive" ], "summary": "Save To Drive", "description": "Move a reel or product media to the permanent drive", "operationId": "save_to_drive_drive_save__media_id__post", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "media_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Media Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/drive/remove/{media_id}": { "delete": { "tags": [ "Pinny Drive" ], "summary": "Remove From Drive", "description": "Remove media from permanent drive (it will revert to standard retention)", "operationId": "remove_from_drive_drive_remove__media_id__delete", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "media_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Media Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/marketplace/rates": { "get": { "tags": [ "Marketplace" ], "summary": "Get Market Rates", "operationId": "get_market_rates_marketplace_rates_get", "parameters": [ { "name": "location", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Location" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MarketRates" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/marketplace/requests": { "post": { "tags": [ "Marketplace" ], "summary": "Create Marketplace Request", "description": "Create a new marketplace request.", "operationId": "create_marketplace_request_marketplace_requests_post", "security": [ { "OAuth2PasswordBearer": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MarketplaceRequestCreate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MarketplaceRequest" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "Marketplace" ], "summary": "Get Marketplace Requests", "description": "Get all marketplace requests with requester info.", "operationId": "get_marketplace_requests_marketplace_requests_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 20, "title": "Limit" } }, { "name": "skip", "in": "query", "required": false, "schema": { "type": "integer", "default": 0, "title": "Skip" } }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/RequestStatus" }, { "type": "null" } ], "title": "Status" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/MarketplaceRequest" }, "title": "Response Get Marketplace Requests Marketplace Requests Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/marketplace/products": { "get": { "tags": [ "Marketplace" ], "summary": "Get Marketplace Products", "description": "Unified marketplace products endpoint.\nFilters by type (MOVIE, PROTECTED, MEDIA, CONTENT, etc) and search query.", "operationId": "get_marketplace_products_marketplace_products_get", "parameters": [ { "name": "type", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Type" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 20, "title": "Limit" } }, { "name": "skip", "in": "query", "required": false, "schema": { "type": "integer", "default": 0, "title": "Skip" } }, { "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" } } } } } } }, "/marketplace/products/{product_id}": { "get": { "tags": [ "Marketplace" ], "summary": "Get Marketplace Product", "operationId": "get_marketplace_product_marketplace_products__product_id__get", "parameters": [ { "name": "product_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Product Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/marketplace/requests/{request_id}": { "get": { "tags": [ "Marketplace" ], "summary": "Get Marketplace Request", "description": "Get a single marketplace request with requester info", "operationId": "get_marketplace_request_marketplace_requests__request_id__get", "parameters": [ { "name": "request_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Request Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MarketplaceRequest" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "put": { "tags": [ "Marketplace" ], "summary": "Update Marketplace Request", "description": "Update a marketplace request", "operationId": "update_marketplace_request_marketplace_requests__request_id__put", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "request_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Request Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MarketplaceRequestCreate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MarketplaceRequest" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "Marketplace" ], "summary": "Delete Marketplace Request", "description": "Delete a marketplace request", "operationId": "delete_marketplace_request_marketplace_requests__request_id__delete", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "request_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Request Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/marketplace/requests/{request_id}/offers": { "post": { "tags": [ "Marketplace" ], "summary": "Create Marketplace Offer", "description": "Submit an offer for a marketplace request", "operationId": "create_marketplace_offer_marketplace_requests__request_id__offers_post", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "request_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Request Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Offer Data" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MarketplaceOffer" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "Marketplace" ], "summary": "Get Marketplace Offers", "description": "Get all offers for a marketplace request. Only requester or admin can see all.", "operationId": "get_marketplace_offers_marketplace_requests__request_id__offers_get", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "request_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Request Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/MarketplaceOffer" }, "title": "Response Get Marketplace Offers Marketplace Requests Request Id Offers Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/marketplace/offers/{offer_id}/status": { "put": { "tags": [ "Marketplace" ], "summary": "Update Offer Status", "description": "Accept or reject a marketplace offer. Implements ESCROW on acceptance.", "operationId": "update_offer_status_marketplace_offers__offer_id__status_put", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "offer_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Offer Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "string" }, "title": "Status Update" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MarketplaceOffer" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/marketplace/offers/{offer_id}/complete": { "post": { "tags": [ "Marketplace" ], "summary": "Complete Marketplace Offer", "description": "Confirm completion and release ESCROW funds to provider.", "operationId": "complete_marketplace_offer_marketplace_offers__offer_id__complete_post", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "offer_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Offer Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MarketplaceOffer" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/marketplace/offers/{offer_id}/cancel": { "post": { "tags": [ "Marketplace" ], "summary": "Cancel Marketplace Offer", "description": "Cancel an in-progress offer and refund ESCROW funds to requester.", "operationId": "cancel_marketplace_offer_marketplace_offers__offer_id__cancel_post", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "offer_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Offer Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MarketplaceOffer" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/bookings/availability/{provider_id}": { "get": { "tags": [ "Bookings" ], "summary": "Get Provider Availability", "description": "Get provider's working hours and existing bookings to show availability.", "operationId": "get_provider_availability_bookings_availability__provider_id__get", "parameters": [ { "name": "provider_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Provider Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/bookings/": { "post": { "tags": [ "Bookings" ], "summary": "Create Booking", "description": "Create a new booking request", "operationId": "create_booking_bookings__post", "security": [ { "OAuth2PasswordBearer": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BookingCreate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Booking" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "Bookings" ], "summary": "Get Bookings", "description": "Get bookings for current user", "operationId": "get_bookings_bookings__get", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "role", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Role" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/Booking" }, "title": "Response Get Bookings Bookings Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/bookings": { "post": { "tags": [ "Bookings" ], "summary": "Create Booking Alias", "operationId": "create_booking_alias_bookings_post", "security": [ { "OAuth2PasswordBearer": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BookingCreate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Booking" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "Bookings" ], "summary": "Get Bookings Alias", "operationId": "get_bookings_alias_bookings_get", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "role", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Role" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/Booking" }, "title": "Response Get Bookings Alias Bookings Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/bookings/{booking_id}/status": { "put": { "tags": [ "Bookings" ], "summary": "Update Booking Status", "description": "Update booking status (Accept/Reject/Cancel/Complete) with full escrow logic", "operationId": "update_booking_status_bookings__booking_id__status_put", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "booking_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Booking Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BookingStatusUpdate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Booking" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/bookings/dispute": { "post": { "tags": [ "Bookings" ], "summary": "Create Dispute", "description": "Create a new dispute ticket", "operationId": "create_dispute_bookings_dispute_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DisputeCreate" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/messenger/smart-replies": { "post": { "tags": [ "Messenger" ], "summary": "Get Smart Replies", "description": "Generate quick reply suggestions for a creator based on chat context.\nRequires PRO subscription.", "operationId": "get_smart_replies_messenger_smart_replies_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SmartReplyRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "items": { "type": "string" }, "type": "array", "title": "Response Get Smart Replies Messenger Smart Replies Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/messenger/conversations": { "get": { "tags": [ "Messenger" ], "summary": "List Conversations", "description": "List all conversations for the current user.", "operationId": "list_conversations_messenger_conversations_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/Conversation" }, "type": "array", "title": "Response List Conversations Messenger Conversations Get" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/messenger/send": { "post": { "tags": [ "Messenger" ], "summary": "Send Message", "description": "Send a message (Text, Image, PPV, etc.) to another user.", "operationId": "send_message_messenger_send_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SendMessageRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Message" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/messenger/messages/{message_id}/unlock": { "post": { "tags": [ "Messenger" ], "summary": "Unlock Ppv Message", "description": "Unlock a PPV message using Pinny Credits.", "operationId": "unlock_ppv_message_messenger_messages__message_id__unlock_post", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "message_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Message Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Message" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/messenger/conversations/{conversation_id}/messages": { "get": { "tags": [ "Messenger" ], "summary": "Get Messages", "description": "Get messages for a conversation.", "operationId": "get_messages_messenger_conversations__conversation_id__messages_get", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "conversation_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Conversation Id" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 50, "title": "Limit" } }, { "name": "skip", "in": "query", "required": false, "schema": { "type": "integer", "default": 0, "title": "Skip" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/Message" }, "title": "Response Get Messages Messenger Conversations Conversation Id Messages Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/messenger/conversations/{conversation_id}/read": { "post": { "tags": [ "Messenger" ], "summary": "Mark Read", "description": "Mark all messages in a conversation as read.", "operationId": "mark_read_messenger_conversations__conversation_id__read_post", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "conversation_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Conversation Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/video/initiate": { "post": { "tags": [ "Video" ], "summary": "Initiate Call", "description": "Initiate a video or voice call.", "operationId": "initiate_call_video_initiate_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InitiateCallRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Call" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/video/{call_id}/heartbeat": { "post": { "tags": [ "Video" ], "summary": "Call Heartbeat", "description": "Maintain call and deduct credits every minute.", "operationId": "call_heartbeat_video__call_id__heartbeat_post", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "call_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Call Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/video/{call_id}/answer": { "post": { "tags": [ "Video" ], "summary": "Answer Call", "description": "Answer an incoming call.", "operationId": "answer_call_video__call_id__answer_post", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "call_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Call Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/video/{call_id}/end": { "post": { "tags": [ "Video" ], "summary": "End Call", "description": "End a call and trigger intelligence processing.", "operationId": "end_call_video__call_id__end_post", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "call_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Call Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/video/history/me": { "get": { "tags": [ "Video" ], "summary": "Get My Call History", "description": "Get history of video/voice calls for the current user.", "operationId": "get_my_call_history_video_history_me_get", "security": [ { "OAuth2PasswordBearer": [] } ], "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" } } } } } } }, "/video/{call_id}": { "get": { "tags": [ "Video" ], "summary": "Get Call", "description": "Get call details.", "operationId": "get_call_video__call_id__get", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "call_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Call Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Call" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/streams/health": { "get": { "tags": [ "Streams" ], "summary": "Health Check", "description": "Check health of the streaming service.", "operationId": "health_check_streams_health_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/streams/start": { "post": { "tags": [ "Streams" ], "summary": "Start Stream", "description": "Initialize a stream session and get RTMP/HLS details.", "operationId": "start_stream_streams_start_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StartStreamRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StartStreamResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/streams/{stream_id}/access": { "get": { "tags": [ "Streams" ], "summary": "Check Stream Access", "description": "Check if a user has access to a stream and return pricing info.", "operationId": "check_stream_access_streams__stream_id__access_get", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "stream_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Stream Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/streams/{stream_id}/heartbeat": { "post": { "tags": [ "Streams" ], "summary": "Stream Heartbeat", "description": "Maintain access and deduct pay-per-minute fees for a stream.", "operationId": "stream_heartbeat_streams__stream_id__heartbeat_post", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "stream_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Stream Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/streams/{stream_id}/tip": { "post": { "tags": [ "Streams" ], "summary": "Send Stream Tip", "description": "Send a tip to a live stream.", "operationId": "send_stream_tip_streams__stream_id__tip_post", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "stream_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Stream Id" } } ], "requestBody": { "required": true, "content": { "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/Body_send_stream_tip_streams__stream_id__tip_post" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/streams/stop/{stream_id}": { "post": { "tags": [ "Streams" ], "summary": "Stop Stream", "description": "Explicitly stop a stream.", "operationId": "stop_stream_streams_stop__stream_id__post", "parameters": [ { "name": "stream_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Stream Id" } }, { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string", "title": "User Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/streams/user/{user_id}/stream": { "get": { "tags": [ "Streams" ], "summary": "Get Stream By User", "description": "Get the current stream (active or not) for a specific user.", "operationId": "get_stream_by_user_streams_user__user_id__stream_get", "parameters": [ { "name": "user_id", "in": "path", "required": true, "schema": { "type": "string", "title": "User Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StreamInfo" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/streams/on_publish": { "post": { "tags": [ "Streams" ], "summary": "On Publish", "description": "Handle Nginx RTMP on_publish callback.\n'name' parameter is now the secret stream_key.", "operationId": "on_publish_streams_on_publish_post", "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/Body_on_publish_streams_on_publish_post" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/streams/on_publish_done": { "post": { "tags": [ "Streams" ], "summary": "On Publish Done", "description": "Handle Nginx RTMP on_publish_done callback.", "operationId": "on_publish_done_streams_on_publish_done_post", "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/Body_on_publish_done_streams_on_publish_done_post" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/streams/on_record_done": { "post": { "tags": [ "Streams" ], "summary": "On Record Done", "description": "Handle Nginx RTMP on_record_done callback.\nLog recording completion.", "operationId": "on_record_done_streams_on_record_done_post", "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/Body_on_record_done_streams_on_record_done_post" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/streams/": { "get": { "tags": [ "Streams" ], "summary": "List Active Streams", "description": "List all active live streams.\nReads from the shared 'streams' collection.", "operationId": "list_active_streams_streams__get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/streams/{stream_id}": { "get": { "tags": [ "Streams" ], "summary": "Get Stream", "description": "Get details for a specific stream.", "operationId": "get_stream_streams__stream_id__get", "parameters": [ { "name": "stream_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Stream Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StreamInfo" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/streams/{room_id}/messages": { "get": { "tags": [ "Streams" ], "summary": "Get Room Messages", "description": "Get recent chat messages and tips for a stream room.", "operationId": "get_room_messages_streams__room_id__messages_get", "parameters": [ { "name": "room_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Room Id" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 50, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "title": "Response Get Room Messages Streams Room Id Messages Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/wallet/balance": { "get": { "tags": [ "Wallet & Payments" ], "summary": "Get Wallet Balance", "description": "Get current user's wallet balance (via Wallet Service).", "operationId": "get_wallet_balance_wallet_balance_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Get Wallet Balance Wallet Balance Get" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/wallet/transactions": { "get": { "tags": [ "Wallet & Payments" ], "summary": "Get Transactions", "description": "Get transaction history (via Wallet Service).", "operationId": "get_transactions_wallet_transactions_get", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 20, "title": "Limit" } }, { "name": "skip", "in": "query", "required": false, "schema": { "type": "integer", "default": 0, "title": "Skip" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "title": "Response Get Transactions Wallet Transactions Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "post": { "tags": [ "Wallet & Payments" ], "summary": "Create Transaction", "description": "Proxy transaction creation to Wallet Service.", "operationId": "create_transaction_wallet_transactions_post", "security": [ { "OAuth2PasswordBearer": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WalletChargeRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/wallet/topup": { "post": { "tags": [ "Wallet & Payments" ], "summary": "Initiate Topup", "description": "Initiate Pinny Credits top-up with various payment providers.\nNOWPayments.io is the primary recommended provider (Stripe/PayPal alternative).\nSupports both crypto payments and FIAT payments via Custody providers.", "operationId": "initiate_topup_wallet_topup_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TopUpRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/wallet/subscribe": { "post": { "tags": [ "Wallet & Payments" ], "summary": "Subscribe Pinnypro", "description": "Proxy subscription to Wallet Service.", "operationId": "subscribe_pinnypro_wallet_subscribe_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SubscriptionRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/wallet/verify-crypto": { "post": { "tags": [ "Wallet & Payments" ], "summary": "Verify Crypto Payment", "description": "Verify crypto transaction via Payment Service (Hermes) and credit via Wallet Service.", "operationId": "verify_crypto_payment_wallet_verify_crypto_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CryptoVerificationRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/wallet/withdraw": { "post": { "tags": [ "Wallet & Payments" ], "summary": "Create Withdrawal", "description": "Create a withdrawal request", "operationId": "create_withdrawal_wallet_withdraw_post", "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Withdrawal Data" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Withdrawal" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/wallet/withdrawals": { "get": { "tags": [ "Wallet & Payments" ], "summary": "Get Withdrawals", "description": "Get withdrawal history", "operationId": "get_withdrawals_wallet_withdrawals_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/Withdrawal" }, "type": "array", "title": "Response Get Withdrawals Wallet Withdrawals Get" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/wallet/exchange-rates": { "get": { "tags": [ "Wallet & Payments" ], "summary": "Get Exchange Rates", "description": "Get current crypto exchange rates (EUR base)", "operationId": "get_exchange_rates_wallet_exchange_rates_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/wallet/bridge/convert": { "post": { "tags": [ "Wallet & Payments" ], "summary": "Convert To Pinnypro", "description": "Proxy bridge conversion to Wallet Service.", "operationId": "convert_to_pinnypro_wallet_bridge_convert_post", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "amount_pinny", "in": "query", "required": true, "schema": { "type": "number", "title": "Amount Pinny" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/wallet/anchor-authorship": { "post": { "tags": [ "Wallet & Payments" ], "summary": "Anchor Authorship", "description": "Proxy Authorship Anchoring to Wallet Service.", "operationId": "anchor_authorship_wallet_anchor_authorship_post", "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Metadata" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/wallet/webhook/drcp": { "post": { "tags": [ "Wallet & Payments" ], "summary": "Drcp Webhook", "description": "Handle dRCP payment callbacks.", "operationId": "drcp_webhook_wallet_webhook_drcp_post", "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Payload" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/wallet/webhook/nowpayments": { "post": { "tags": [ "Wallet & Payments" ], "summary": "Nowpayments Webhook", "description": "Handle NOWPayments.io payment callbacks (IPN).", "operationId": "nowpayments_webhook_wallet_webhook_nowpayments_post", "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Payload" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/webhooks/paypal": { "post": { "tags": [ "Webhooks" ], "summary": "Paypal Webhook", "operationId": "paypal_webhook_webhooks_paypal_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/webhooks/nowpayments": { "post": { "tags": [ "Webhooks" ], "summary": "Nowpayments Webhook", "operationId": "nowpayments_webhook_webhooks_nowpayments_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/notifications/read-all": { "post": { "tags": [ "Notifications" ], "summary": "Mark All Read Endpoint", "operationId": "mark_all_read_endpoint_notifications_read_all_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/notifications/": { "get": { "tags": [ "Notifications" ], "summary": "List Notifications", "operationId": "list_notifications_notifications__get", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 20, "title": "Limit" } }, { "name": "skip", "in": "query", "required": false, "schema": { "type": "integer", "default": 0, "title": "Skip" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/notifications/{notification_id}/read": { "post": { "tags": [ "Notifications" ], "summary": "Mark Read", "operationId": "mark_read_notifications__notification_id__read_post", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "notification_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Notification Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/claim/request": { "post": { "tags": [ "Profile Claiming" ], "summary": "Request Claim", "description": "Creator requests to claim a shadow profile.", "operationId": "request_claim_claim_request_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClaimRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/claim/{claim_id}/approve": { "post": { "tags": [ "Profile Claiming" ], "summary": "Approve Claim", "description": "Admin approves a claim request, merging data.", "operationId": "approve_claim_claim__claim_id__approve_post", "parameters": [ { "name": "claim_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Claim Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/metadata/taxonomy": { "get": { "tags": [ "Metadata / Taxonomy" ], "summary": "Get Taxonomy", "description": "Returns the global PINNY taxonomy for filters, categories, and attributes.\nThis is the source of truth for all services and the frontend.\nUpdated via Pinny Core.", "operationId": "get_taxonomy_metadata_taxonomy_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/media/upload": { "post": { "tags": [ "Media Serving" ], "summary": "Upload Media", "description": "Generic media upload endpoint.", "operationId": "upload_media_media_upload_post", "requestBody": { "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/Body_upload_media_media_upload_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": [ { "OAuth2PasswordBearer": [] } ] } }, "/media/{file_path}": { "get": { "tags": [ "Media Serving" ], "summary": "Serve Media", "description": "Serve media files from Unified Storage (R2/MinIO).\nSupports all prefixes (media/scraped/, users/, etc.)", "operationId": "serve_media_media__file_path__get", "parameters": [ { "name": "file_path", "in": "path", "required": true, "schema": { "type": "string", "title": "File Path" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/admin/audit/trigger": { "post": { "tags": [ "Admin" ], "summary": "Trigger Full Audit", "description": "Trigger a full system integrity audit.", "operationId": "trigger_full_audit_admin_audit_trigger_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/admin/audit/reports": { "get": { "tags": [ "Admin" ], "summary": "Get Audit Reports", "description": "Get the latest system integrity audit reports.", "operationId": "get_audit_reports_admin_audit_reports_get", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "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" } } } } } } }, "/admin/system/config": { "get": { "tags": [ "Admin" ], "summary": "Get System Config", "description": "Get all system configurations with masking for secrets.", "operationId": "get_system_config_admin_system_config_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] }, "post": { "tags": [ "Admin" ], "summary": "Update System Config", "description": "Update or create a system configuration entry.", "operationId": "update_system_config_admin_system_config_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SystemConfigEntry" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/admin/system/pulse": { "get": { "tags": [ "Admin" ], "summary": "Get System Pulse", "description": "Run lightweight readiness checks for AI key and scraper cluster.", "operationId": "get_system_pulse_admin_system_pulse_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/admin/system/health": { "get": { "tags": [ "Admin" ], "summary": "Get System Health", "description": "Get the latest system health report from the Core System.\nAggregates data from the QA Agent and Coordinator status.", "operationId": "get_system_health_admin_system_health_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/admin/system/health/trigger": { "post": { "tags": [ "Admin" ], "summary": "Trigger Health Check", "description": "Manually trigger a System QA Pulse Check.", "operationId": "trigger_health_check_admin_system_health_trigger_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/admin/system/audit/discovery": { "post": { "tags": [ "Admin" ], "summary": "Trigger Discovery Audit", "description": "Trigger a Structural Integrity Audit (Discovery Phase) via Core System.", "operationId": "trigger_discovery_audit_admin_system_audit_discovery_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/admin/system/audit/permissions": { "post": { "tags": [ "Admin" ], "summary": "Trigger Permission Audit", "description": "Trigger a Security Permission Audit via Core System.", "operationId": "trigger_permission_audit_admin_system_audit_permissions_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/admin/system/audit/financial": { "post": { "tags": [ "Admin" ], "summary": "Trigger Financial Audit", "description": "Trigger a Financial Integrity Audit via Core System.", "operationId": "trigger_financial_audit_admin_system_audit_financial_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/admin/system/audit/orphans": { "post": { "tags": [ "Admin" ], "summary": "Trigger Orphan Audit", "description": "Trigger an Orphan & Dead Component Audit via Core System.", "operationId": "trigger_orphan_audit_admin_system_audit_orphans_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/admin/system/audit/behavior": { "post": { "tags": [ "Admin" ], "summary": "Trigger Behavior Audit", "description": "Trigger multiple User Behavior Flow Audits (Discovery, Creator, Premium) via Core System.", "operationId": "trigger_behavior_audit_admin_system_audit_behavior_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/admin/system/audit/performance": { "post": { "tags": [ "Admin" ], "summary": "Trigger Performance Audit", "description": "Trigger a Performance & Response Time Audit via Core System.", "operationId": "trigger_performance_audit_admin_system_audit_performance_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/admin/system/audit/regression": { "post": { "tags": [ "Admin" ], "summary": "Trigger Regression Audit", "description": "Trigger a Regression Detection Audit via Core System.", "operationId": "trigger_regression_audit_admin_system_audit_regression_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/admin/system/audit/concurrency": { "post": { "tags": [ "Admin" ], "summary": "Trigger Concurrency Audit", "description": "Trigger a Concurrency & Race Condition Audit via Core System.", "operationId": "trigger_concurrency_audit_admin_system_audit_concurrency_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/admin/system/audit/infrastructure": { "post": { "tags": [ "Admin" ], "summary": "Trigger Infra Audit", "description": "Trigger an Infrastructure Health Audit via Core System.", "operationId": "trigger_infra_audit_admin_system_audit_infrastructure_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/admin/system/audit/code": { "post": { "tags": [ "Admin" ], "summary": "Trigger Code Audit", "description": "Trigger a Static Code Integrity Audit (TODOs/FIXMEs) via Core System.", "operationId": "trigger_code_audit_admin_system_audit_code_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/admin/system/audit/mutations": { "post": { "tags": [ "Admin" ], "summary": "Trigger Mutation Audit", "description": "Trigger a State Mutation Validation Audit via Core System.", "operationId": "trigger_mutation_audit_admin_system_audit_mutations_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/admin/system/audit/results/{task_id}": { "get": { "tags": [ "Admin" ], "summary": "Get Audit Results", "description": "Retrieve the results of a specific audit task from the Core memory.", "operationId": "get_audit_results_admin_system_audit_results__task_id__get", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "task_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Task Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/admin/system/audit/summary": { "get": { "tags": [ "Admin" ], "summary": "Get Audit Summary", "description": "Generate a consolidated Structural Integrity Report based on the latest Swarm tasks.\nCalculates the final Integrity Score.", "operationId": "get_audit_summary_admin_system_audit_summary_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/admin/system/bookings": { "get": { "tags": [ "Admin" ], "summary": "Get System Bookings", "description": "Admin tool to view and filter all bookings/disputes.", "operationId": "get_system_bookings_admin_system_bookings_get", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Status" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 50, "title": "Limit" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "default": 0, "title": "Offset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/admin/system/disputes/{booking_id}/resolve": { "post": { "tags": [ "Admin" ], "summary": "Resolve Dispute Manually", "description": "Manually resolve a dispute by triggering escrow actions.", "operationId": "resolve_dispute_manually_admin_system_disputes__booking_id__resolve_post", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "booking_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Booking Id" } }, { "name": "action", "in": "query", "required": true, "schema": { "type": "string", "pattern": "^(REFUND|PAYOUT)$", "title": "Action" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/admin/system/ledger": { "get": { "tags": [ "Admin" ], "summary": "Get Global Ledger", "description": "Admin tool to view all financial transactions across the platform.", "operationId": "get_global_ledger_admin_system_ledger_get", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 50, "title": "Limit" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "default": 0, "title": "Offset" } }, { "name": "type", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Type" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/admin/system/audit/signoff": { "get": { "tags": [ "Admin" ], "summary": "Get Production Signoff", "description": "Final Production Sign-off Report.\nConsolidates all Swarm insights into a high-level executive summary.", "operationId": "get_production_signoff_admin_system_audit_signoff_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/admin/system/audit/widget": { "get": { "tags": [ "Admin" ], "summary": "Get Health Widget Data", "description": "Simplified, high-performance data for the Admin Dashboard Integrity Widget.", "operationId": "get_health_widget_data_admin_system_audit_widget_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/admin/system/audit/regression/promote/{snapshot_id}": { "post": { "tags": [ "Admin" ], "summary": "Promote To Baseline", "description": "Mark a specific snapshot as the official 'Gilded Baseline' for regression detection.", "operationId": "promote_to_baseline_admin_system_audit_regression_promote__snapshot_id__post", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "snapshot_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Snapshot Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/admin/system/audit/export/markdown": { "get": { "tags": [ "Admin" ], "summary": "Export Audit Markdown", "description": "Generates a beautifully formatted Markdown report of the latest audit results.", "operationId": "export_audit_markdown_admin_system_audit_export_markdown_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/admin/verifications/pending": { "get": { "tags": [ "Admin" ], "summary": "Get Pending Verifications", "description": "List users with pending KYC or Health verification", "operationId": "get_pending_verifications_admin_verifications_pending_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/admin/users/{user_id}/documents": { "get": { "tags": [ "Admin" ], "summary": "Get User Documents", "description": "Get signed URLs for user's verification documents", "operationId": "get_user_documents_admin_users__user_id__documents_get", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "user_id", "in": "path", "required": true, "schema": { "type": "string", "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/verifications/{user_id}/review": { "put": { "tags": [ "Admin" ], "summary": "Review Verification", "description": "Approve or reject a verification request", "operationId": "review_verification_admin_verifications__user_id__review_put", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "user_id", "in": "path", "required": true, "schema": { "type": "string", "title": "User Id" } }, { "name": "type", "in": "query", "required": true, "schema": { "type": "string", "pattern": "^(kyc|health)$", "title": "Type" } }, { "name": "action", "in": "query", "required": true, "schema": { "type": "string", "pattern": "^(approve|reject)$", "title": "Action" } }, { "name": "level", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "New verification level (1-3)", "title": "Level" }, "description": "New verification level (1-3)" }, { "name": "notes", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Notes" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/admin/users": { "get": { "tags": [ "Admin" ], "summary": "Get Users", "operationId": "get_users_admin_users_get", "security": [ { "OAuth2PasswordBearer": [] } ], "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": "search", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Search" } }, { "name": "role", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Role" } } ], "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}/status": { "put": { "tags": [ "Admin" ], "summary": "Update User Status", "operationId": "update_user_status_admin_users__user_id__status_put", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "user_id", "in": "path", "required": true, "schema": { "type": "string", "title": "User Id" } }, { "name": "action", "in": "query", "required": true, "schema": { "type": "string", "pattern": "^(ban|unban|verify|unverify)$", "title": "Action" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/stash/profiles": { "get": { "tags": [ "Stash" ], "summary": "Get Stashed Profiles", "description": "Get all profiles in user's stash (wishlist)", "operationId": "get_stashed_profiles_stash_profiles_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/UserProfile" }, "type": "array", "title": "Response Get Stashed Profiles Stash Profiles Get" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/stash/profiles/{profile_id}": { "post": { "tags": [ "Stash" ], "summary": "Add Profile To Stash", "description": "Add a profile to stash (wishlist)", "operationId": "add_profile_to_stash_stash_profiles__profile_id__post", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "profile_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Profile Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "Stash" ], "summary": "Remove Profile From Stash", "description": "Remove a profile from stash (wishlist)", "operationId": "remove_profile_from_stash_stash_profiles__profile_id__delete", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "profile_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Profile Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/stash/purchases": { "get": { "tags": [ "Stash" ], "summary": "Get Purchased Items", "description": "Get all purchased products in user's stash", "operationId": "get_purchased_items_stash_purchases_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/Product" }, "type": "array", "title": "Response Get Purchased Items Stash Purchases Get" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/stash/products": { "get": { "tags": [ "Stash" ], "summary": "Get Stashed Products", "description": "Get all products in user's wishlist (not necessarily purchased)", "operationId": "get_stashed_products_stash_products_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/Product" }, "type": "array", "title": "Response Get Stashed Products Stash Products Get" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/stash/products/{product_id}": { "post": { "tags": [ "Stash" ], "summary": "Add Product To Stash", "description": "Add a product to wishlist", "operationId": "add_product_to_stash_stash_products__product_id__post", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "product_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Product Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "Stash" ], "summary": "Remove Product From Stash", "description": "Remove a product from wishlist", "operationId": "remove_product_from_stash_stash_products__product_id__delete", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "product_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Product Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/studio/text/generate": { "post": { "tags": [ "studio" ], "summary": "Studio Text Generate", "description": "Generate creative text (Seduction Script, Bios, etc.) (Cost: 1 Credit).", "operationId": "studio_text_generate_studio_text_generate_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TextGenerationRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TextGenerationResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/studio/image/generate": { "post": { "tags": [ "studio" ], "summary": "Studio Image Generate", "description": "Generate or enhance images using AI (Cost: 2 Credits).", "operationId": "studio_image_generate_studio_image_generate_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateImageRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/studio/video/enhance": { "post": { "tags": [ "studio" ], "summary": "Studio Video Enhance", "description": "Enhance video (Upscale/Stabilize) (Cost: 5 Credits).\nUses moviepy for basic enhancement (resize, color boost) to simulate 'AI' processing\nuntil GPU nodes are available.", "operationId": "studio_video_enhance_studio_video_enhance_post", "requestBody": { "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/Body_studio_video_enhance_studio_video_enhance_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": [ { "OAuth2PasswordBearer": [] } ] } }, "/studio/video/generate": { "post": { "tags": [ "studio" ], "summary": "Studio Video Generate", "operationId": "studio_video_generate_studio_video_generate_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateVideoRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/studio/recycle": { "post": { "tags": [ "studio" ], "summary": "Studio Recycle", "description": "Recycle content using AI for creators.", "operationId": "studio_recycle_studio_recycle_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RecycleRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/studio/safety/register": { "post": { "tags": [ "studio" ], "summary": "Safety Register", "description": "Register content on IOTA Rebased for on-chain copyright protection.", "operationId": "safety_register_studio_safety_register_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SafetyRegisterRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/studio/analytics/heatmap": { "get": { "tags": [ "studio" ], "summary": "Studio Analytics Heatmap", "description": "Returns tactical heatmap data for the creator's content.", "operationId": "studio_analytics_heatmap_studio_analytics_heatmap_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/studio/analytics/funnel": { "get": { "tags": [ "studio" ], "summary": "Studio Analytics Funnel", "description": "Returns conversion funnel data.", "operationId": "studio_analytics_funnel_studio_analytics_funnel_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/studio/gatekeeper/check": { "get": { "tags": [ "studio" ], "summary": "Gatekeeper Check", "operationId": "gatekeeper_check_studio_gatekeeper_check_get", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "q", "in": "query", "required": true, "schema": { "type": "string", "title": "Q" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/seo/generate-metadata": { "post": { "tags": [ "SEO" ], "summary": "Generate Seo Metadata", "description": "Generate AI-powered SEO metadata for a profile.\nOnly accessible by the profile owner or an admin.", "operationId": "generate_seo_metadata_seo_generate_metadata_post", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "profile_id", "in": "query", "required": true, "schema": { "type": "string", "title": "Profile Id" } }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string", "default": "English", "title": "Lang" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/seo/sitemap-index": { "get": { "tags": [ "SEO" ], "summary": "Get Sitemap Index", "description": "Get list of all generated SEO URLs for sitemap generation.", "operationId": "get_sitemap_index_seo_sitemap_index_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 1000, "title": "Limit" } }, { "name": "skip", "in": "query", "required": false, "schema": { "type": "integer", "default": 0, "title": "Skip" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "string" }, "title": "Response Get Sitemap Index Seo Sitemap Index Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/seo/page-data": { "get": { "tags": [ "SEO" ], "summary": "Get Seo Page Data", "description": "Resolve a specific SEO path to the underlying profile and context data.\nUsed by frontend to render the dynamic SEO pages.", "operationId": "get_seo_page_data_seo_page_data_get", "parameters": [ { "name": "path", "in": "query", "required": true, "schema": { "type": "string", "description": "The URL path to resolve", "title": "Path" }, "description": "The URL path to resolve" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/scraper/scan": { "post": { "tags": [ "Scraper" ], "summary": "Scan Profile", "description": "Scan a single profile URL (Requires ULTIMATE tier or specific permission)", "operationId": "scan_profile_scraper_scan_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScanRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Scan Profile Scraper Scan Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/scraper/import": { "post": { "tags": [ "Scraper" ], "summary": "Import Profile", "description": "Import a scraped profile into the current user's account", "operationId": "import_profile_scraper_import_post", "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Profile Data" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Import Profile Scraper Import Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/scraper/scrape-all": { "post": { "tags": [ "Scraper" ], "summary": "Scrape All Competitors", "description": "Trigger scraping of all configured competitors (ADMIN only)", "operationId": "scrape_all_competitors_scraper_scrape_all_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Scrape All Competitors Scraper Scrape All Post" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/scraper/last-run": { "get": { "tags": [ "Scraper" ], "summary": "Get Last Scrape Run", "operationId": "get_last_scrape_run_scraper_last_run_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Get Last Scrape Run Scraper Last Run Get" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/scraper/runtime-state": { "get": { "tags": [ "Scraper" ], "summary": "Get Scraper Runtime State", "operationId": "get_scraper_runtime_state_scraper_runtime_state_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Get Scraper Runtime State Scraper Runtime State Get" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/scraper/runtime-reset": { "post": { "tags": [ "Scraper" ], "summary": "Reset Scraper Runtime State", "operationId": "reset_scraper_runtime_state_scraper_runtime_reset_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Reset Scraper Runtime State Scraper Runtime Reset Post" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/scraper/analytics/market-rates": { "get": { "tags": [ "Scraper" ], "summary": "Get Market Rates", "description": "Get market rate analysis based on scraped data", "operationId": "get_market_rates_scraper_analytics_market_rates_get", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "location", "in": "query", "required": false, "schema": { "type": "string", "title": "Location" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Market Rates Scraper Analytics Market Rates Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/scraper/claimable": { "get": { "tags": [ "Scraper" ], "summary": "Get Claimable Profiles", "description": "Get list of unclaimed scraped profiles for claiming", "operationId": "get_claimable_profiles_scraper_claimable_get", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 50, "title": "Limit" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "default": 0, "title": "Offset" } }, { "name": "location", "in": "query", "required": false, "schema": { "type": "string", "title": "Location" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "title": "Response Get Claimable Profiles Scraper Claimable Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/scraper/claim/{claim_token}": { "post": { "tags": [ "Scraper" ], "summary": "Claim Profile", "description": "Claim a scraped profile for the current user", "operationId": "claim_profile_scraper_claim__claim_token__post", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "claim_token", "in": "path", "required": true, "schema": { "type": "string", "title": "Claim Token" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Claim Profile Scraper Claim Claim Token Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/scraper/profiles": { "get": { "tags": [ "Scraper" ], "summary": "Get Scraped Profiles", "description": "Get scraped profiles (Admin view from users collection)", "operationId": "get_scraped_profiles_scraper_profiles_get", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 50, "title": "Limit" } }, { "name": "skip", "in": "query", "required": false, "schema": { "type": "integer", "default": 0, "title": "Skip" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "title": "Response Get Scraped Profiles Scraper Profiles Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/dmca/claims": { "get": { "tags": [ "DMCA" ], "summary": "Get My Dmca Claims", "description": "Get all DMCA claims for the current user", "operationId": "get_my_dmca_claims_dmca_claims_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/DMCAClaim" }, "type": "array", "title": "Response Get My Dmca Claims Dmca Claims Get" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] }, "post": { "tags": [ "DMCA" ], "summary": "Create Dmca Claim", "description": "Create a new DMCA takedown claim", "operationId": "create_dmca_claim_dmca_claims_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DMCAClaim" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DMCAClaim" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/dmca/stats": { "get": { "tags": [ "DMCA" ], "summary": "Get Dmca Stats", "description": "Get summary stats for DMCA claims", "operationId": "get_dmca_stats_dmca_stats_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/games/spin": { "post": { "tags": [ "Games" ], "summary": "Spin Daily Wheel", "description": "Spin the daily wheel for a chance to win prizes.\nEnforces a 24-hour cooldown.", "operationId": "spin_daily_wheel_games_spin_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SpinResponse" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/games/daily": { "get": { "tags": [ "Games" ], "summary": "Get Daily Oracle", "description": "Get a daily oracle reading.\nIf user is logged in, customize it slightly (future enhancement).", "operationId": "get_daily_oracle_games_daily_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OracleResponse" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/referrals/code": { "get": { "tags": [ "Referrals" ], "summary": "Get Referral Code", "operationId": "get_referral_code_referrals_code_get", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "user_id", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "User Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/referrals/summary": { "get": { "tags": [ "Referrals" ], "summary": "Get Referral Summary", "operationId": "get_referral_summary_referrals_summary_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/referrals/payouts": { "get": { "tags": [ "Referrals" ], "summary": "Get Referral Payouts", "description": "Fetch history of referral commission payouts.", "operationId": "get_referral_payouts_referrals_payouts_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/orus/verify-age": { "post": { "tags": [ "Orus Proxy" ], "summary": "Proxy Verify Age", "description": "Proxy age verification request to Orus service", "operationId": "proxy_verify_age_orus_verify_age_post", "requestBody": { "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/Body_proxy_verify_age_orus_verify_age_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": [ { "OAuth2PasswordBearer": [] } ] } }, "/orus/verify-health": { "post": { "tags": [ "Orus Proxy" ], "summary": "Proxy Verify Health", "description": "Proxy health verification request to Orus service", "operationId": "proxy_verify_health_orus_verify_health_post", "requestBody": { "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/Body_proxy_verify_health_orus_verify_health_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": [ { "OAuth2PasswordBearer": [] } ] } }, "/copyright/anchor": { "post": { "tags": [ "System: Authorship Anchoring" ], "summary": "Anchor Authorship", "description": "Anchor a Proof-of-Authorship certificate for a Verified Profile on IOTA Rebased.", "operationId": "anchor_authorship_copyright_anchor_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AnchorRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/copyright/proofs": { "get": { "tags": [ "System: Authorship Anchoring" ], "summary": "Get My Proofs", "description": "Fetch all copyright proofs owned by the current user.", "operationId": "get_my_proofs_copyright_proofs_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/analytics/track": { "post": { "tags": [ "Analytics" ], "summary": "Track Event", "description": "Captures high-precision tracking data for creator funnels.", "operationId": "track_event_analytics_track_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AnalyticsEvent" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/analytics/creator/{creator_id}/summary": { "get": { "tags": [ "Analytics" ], "summary": "Get Creator Analytics", "description": "Returns the 'Creator Intelligence' summary.", "operationId": "get_creator_analytics_analytics_creator__creator_id__summary_get", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "creator_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Creator Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/digital-twin/state": { "get": { "tags": [ "Digital Twin" ], "summary": "Get My Twin State", "description": "Get the current state of the logged-in user's Digital Twin.", "operationId": "get_my_twin_state_digital_twin_state_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DigitalTwinState" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/digital-twin/train": { "post": { "tags": [ "Digital Twin" ], "summary": "Add Training Data", "description": "Upload custom training data (e.g., bio, sales pitch) to the Digital Twin.", "operationId": "add_training_data_digital_twin_train_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TrainingDocRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/digital-twin/upload-document": { "post": { "tags": [ "Digital Twin" ], "summary": "Upload Training File", "description": "Upload a PDF or TXT file to train the Digital Twin.", "operationId": "upload_training_file_digital_twin_upload_document_post", "requestBody": { "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/Body_upload_training_file_digital_twin_upload_document_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": [ { "OAuth2PasswordBearer": [] } ] } }, "/digital-twin/chat": { "post": { "tags": [ "Digital Twin" ], "summary": "Chat With My Twin", "description": "Simulate a chat with your own Digital Twin to test its responses.", "operationId": "chat_with_my_twin_digital_twin_chat_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChatTwinRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/digital-twin/recommendations": { "get": { "tags": [ "Digital Twin" ], "summary": "Get Twin Recommendations", "description": "Fetch recent autonomous recommendations generated by Swarm Agents.", "operationId": "get_twin_recommendations_digital_twin_recommendations_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/digital-twin/sync": { "post": { "tags": [ "Digital Twin" ], "summary": "Trigger Twin Sync", "description": "Manually trigger a data synchronization for the Digital Twin.", "operationId": "trigger_twin_sync_digital_twin_sync_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/verification/submit": { "post": { "tags": [ "KYC & Verification" ], "summary": "Submit Verification", "description": "Submit documents for AI-driven KYC verification.", "operationId": "submit_verification_verification_submit_post", "requestBody": { "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/Body_submit_verification_verification_submit_post" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VerificationResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/verification/status": { "get": { "tags": [ "KYC & Verification" ], "summary": "Get Verification Status", "description": "Get the current user's verification status.", "operationId": "get_verification_status_verification_status_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/mcp/data-quality/profile/{profile_id}": { "get": { "tags": [ "MCP Data Quality" ], "summary": "Get Profile Quality", "operationId": "get_profile_quality_mcp_data_quality_profile__profile_id__get", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "profile_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Profile Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/mcp/data-quality/audit": { "get": { "tags": [ "MCP Data Quality" ], "summary": "Audit Quality", "operationId": "audit_quality_mcp_data_quality_audit_get", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 200, "minimum": 1, "default": 50, "title": "Limit" } }, { "name": "min_score", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 0, "default": 0, "title": "Min Score" } }, { "name": "source", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/mcp/data-quality/superlative-boost": { "post": { "tags": [ "MCP Data Quality" ], "summary": "Superlative Boost", "description": "Mass boost high-potential profiles to superlative discovery status.", "operationId": "superlative_boost_mcp_data_quality_superlative_boost_post", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 5000, "minimum": 1, "default": 1000, "title": "Limit" } }, { "name": "min_score", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 0, "default": 45, "title": "Min Score" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/mcp/verification-control/status/{user_ref}": { "get": { "tags": [ "MCP Verification Control" ], "summary": "Get Verification Control Status", "operationId": "get_verification_control_status_mcp_verification_control_status__user_ref__get", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "user_ref", "in": "path", "required": true, "schema": { "type": "string", "title": "User Ref" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/mcp/verification-control/audit": { "get": { "tags": [ "MCP Verification Control" ], "summary": "Audit Verification Control", "operationId": "audit_verification_control_mcp_verification_control_audit_get", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 200, "minimum": 1, "default": 50, "title": "Limit" } }, { "name": "canonical_status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Canonical Status" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/mcp/boosting-governance/simulate": { "post": { "tags": [ "MCP Boosting Governance" ], "summary": "Simulate Boost Policy", "operationId": "simulate_boost_policy_mcp_boosting_governance_simulate_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BoostSimulationRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/mcp/boosting-governance/audit": { "get": { "tags": [ "MCP Boosting Governance" ], "summary": "Audit Boost Policy", "operationId": "audit_boost_policy_mcp_boosting_governance_audit_get", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 200, "minimum": 1, "default": 50, "title": "Limit" } }, { "name": "min_quality", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 0, "default": 0, "title": "Min Quality" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/mcp/multicurrency-control/normalize": { "post": { "tags": [ "MCP MultiCurrency Control" ], "summary": "Normalize Amount Endpoint", "operationId": "normalize_amount_endpoint_mcp_multicurrency_control_normalize_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NormalizeAmountRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/mcp/multicurrency-control/audit": { "get": { "tags": [ "MCP MultiCurrency Control" ], "summary": "Audit Multicurrency", "operationId": "audit_multicurrency_mcp_multicurrency_control_audit_get", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 200, "minimum": 1, "default": 50, "title": "Limit" } }, { "name": "target_currency", "in": "query", "required": false, "schema": { "type": "string", "default": "USD", "title": "Target Currency" } }, { "name": "tx_type", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Tx Type" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/mcp/next-content-bootstrap/audit": { "get": { "tags": [ "MCP Next Content Bootstrap" ], "summary": "Audit Next Content Bootstrap", "operationId": "audit_next_content_bootstrap_mcp_next_content_bootstrap_audit_get", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 1000, "minimum": 1, "default": 200, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/mcp/next-content-bootstrap/run": { "post": { "tags": [ "MCP Next Content Bootstrap" ], "summary": "Run Next Content Bootstrap", "operationId": "run_next_content_bootstrap_mcp_next_content_bootstrap_run_post", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 2000, "minimum": 1, "default": 300, "title": "Limit" } }, { "name": "trigger_seo_refresh", "in": "query", "required": false, "schema": { "type": "boolean", "default": true, "title": "Trigger Seo Refresh" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/mcp/next-content-bootstrap/hydrate-catalog": { "post": { "tags": [ "MCP Next Content Bootstrap" ], "summary": "Hydrate Visible Catalog", "operationId": "hydrate_visible_catalog_mcp_next_content_bootstrap_hydrate_catalog_post", "parameters": [ { "name": "profile_limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 5000, "minimum": 1, "default": 500, "title": "Profile Limit" } }, { "name": "reel_limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 500, "minimum": 1, "default": 80, "title": "Reel Limit" } }, { "name": "dry_run", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Dry Run" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/mcp/next-content-bootstrap/hydrate-marketplace": { "post": { "tags": [ "MCP Next Content Bootstrap" ], "summary": "Hydrate Marketplace Visibility", "operationId": "hydrate_marketplace_visibility_mcp_next_content_bootstrap_hydrate_marketplace_post", "parameters": [ { "name": "profile_limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 5000, "minimum": 1, "default": 500, "title": "Profile Limit" } }, { "name": "product_limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 2000, "minimum": 1, "default": 200, "title": "Product Limit" } }, { "name": "dry_run", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Dry Run" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/mcp/next-content-bootstrap/hydrate-reels-video": { "post": { "tags": [ "MCP Next Content Bootstrap" ], "summary": "Hydrate Reels Video Sources", "operationId": "hydrate_reels_video_sources_mcp_next_content_bootstrap_hydrate_reels_video_post", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 20000, "minimum": 1, "default": 3000, "title": "Limit" } }, { "name": "dry_run", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Dry Run" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/mcp/next-content-bootstrap/harmonize-source-distribution": { "post": { "tags": [ "MCP Next Content Bootstrap" ], "summary": "Harmonize Source Distribution", "operationId": "harmonize_source_distribution_mcp_next_content_bootstrap_harmonize_source_distribution_post", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 10000, "minimum": 1, "default": 1500, "title": "Limit" } }, { "name": "dry_run", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Dry Run" } }, { "name": "force_reprocess", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Force Reprocess" } }, { "name": "normalize_origin", "in": "query", "required": false, "schema": { "type": "boolean", "default": true, "title": "Normalize Origin" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/health": { "get": { "summary": "Health Check", "description": "Enhanced health check verifying database, storage, queue, and search connectivity", "operationId": "health_check_health_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/metrics": { "get": { "summary": "Metrics", "operationId": "metrics_metrics_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/ai/moderate": { "post": { "summary": "Moderate Endpoint", "description": "Content moderation endpoint.", "operationId": "moderate_endpoint_ai_moderate_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ModerationRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ModerationResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/chat": { "post": { "summary": "Chat Endpoint", "description": "Chat with Pinny Assistant", "operationId": "chat_endpoint_chat_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChatRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChatResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "OAuth2PasswordBearer": [] } ] } }, "/streams/{stream_id}/unlock": { "post": { "tags": [ "Streams" ], "summary": "Unlock Stream Access", "description": "Unlock access for a private stream when no platform payment is required.", "operationId": "purchase_stream_access_streams__stream_id__purchase_access_post", "security": [ { "OAuth2PasswordBearer": [] } ], "parameters": [ { "name": "stream_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Stream Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } } }, "components": { "schemas": { "AnalyticsEvent": { "properties": { "event_type": { "type": "string", "title": "Event Type" }, "target_id": { "type": "string", "title": "Target Id" }, "source": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source", "default": "direct" }, "metadata": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Metadata", "default": {} } }, "type": "object", "required": [ "event_type", "target_id" ], "title": "AnalyticsEvent" }, "AssistantSettings": { "properties": { "enabled": { "type": "boolean", "title": "Enabled", "default": false }, "personality": { "type": "string", "title": "Personality", "default": "sexy" }, "custom_prompt": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Custom Prompt" }, "auto_respond_delay": { "type": "integer", "title": "Auto Respond Delay", "default": 5 }, "auto_upsell_enabled": { "type": "boolean", "title": "Auto Upsell Enabled", "default": false }, "upsell_product_ids": { "items": { "type": "string" }, "type": "array", "title": "Upsell Product Ids" }, "upsell_threshold_messages": { "type": "integer", "title": "Upsell Threshold Messages", "default": 3 } }, "type": "object", "title": "AssistantSettings" }, "Availability": { "properties": { "working_hours": { "items": { "$ref": "#/components/schemas/WorkingHours" }, "type": "array", "title": "Working Hours" }, "closed_dates": { "items": { "type": "string", "format": "date-time" }, "type": "array", "title": "Closed Dates" } }, "type": "object", "title": "Availability" }, "BodyType": { "type": "string", "enum": [ "SLIM", "ATHLETIC", "AVERAGE", "CURVY", "PLUS_SIZE", "MUSCULAR", "BBW" ], "title": "BodyType" }, "Body_login_auth_login_post": { "properties": { "grant_type": { "anyOf": [ { "type": "string", "pattern": "^password$" }, { "type": "null" } ], "title": "Grant Type" }, "username": { "type": "string", "title": "Username" }, "password": { "type": "string", "format": "password", "title": "Password" }, "scope": { "type": "string", "title": "Scope", "default": "" }, "client_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Client Id" }, "client_secret": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "format": "password", "title": "Client Secret" } }, "type": "object", "required": [ "username", "password" ], "title": "Body_login_auth_login_post" }, "Body_on_publish_done_streams_on_publish_done_post": { "properties": { "name": { "type": "string", "title": "Name" } }, "type": "object", "required": [ "name" ], "title": "Body_on_publish_done_streams_on_publish_done_post" }, "Body_on_publish_streams_on_publish_post": { "properties": { "name": { "type": "string", "title": "Name" }, "addr": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Addr" }, "app": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "App" } }, "type": "object", "required": [ "name" ], "title": "Body_on_publish_streams_on_publish_post" }, "Body_on_record_done_streams_on_record_done_post": { "properties": { "name": { "type": "string", "title": "Name" }, "path": { "type": "string", "title": "Path" }, "recorder": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Recorder" } }, "type": "object", "required": [ "name", "path" ], "title": "Body_on_record_done_streams_on_record_done_post" }, "Body_proxy_verify_age_orus_verify_age_post": { "properties": { "user_id": { "type": "string", "title": "User Id" }, "file": { "type": "string", "format": "binary", "title": "File" } }, "type": "object", "required": [ "user_id", "file" ], "title": "Body_proxy_verify_age_orus_verify_age_post" }, "Body_proxy_verify_health_orus_verify_health_post": { "properties": { "user_id": { "type": "string", "title": "User Id" }, "file": { "type": "string", "format": "binary", "title": "File" }, "expiry_days": { "type": "integer", "title": "Expiry Days", "default": 30 } }, "type": "object", "required": [ "user_id", "file" ], "title": "Body_proxy_verify_health_orus_verify_health_post" }, "Body_request_verification_profiles_verification_post": { "properties": { "id_front": { "type": "string", "format": "binary", "title": "Id Front" }, "id_back": { "type": "string", "format": "binary", "title": "Id Back" }, "selfie": { "type": "string", "format": "binary", "title": "Selfie" } }, "type": "object", "required": [ "id_front", "id_back", "selfie" ], "title": "Body_request_verification_profiles_verification_post" }, "Body_send_stream_tip_streams__stream_id__tip_post": { "properties": { "amount": { "type": "number", "title": "Amount" }, "message": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Message", "default": "Sent a tip!" } }, "type": "object", "required": [ "amount" ], "title": "Body_send_stream_tip_streams__stream_id__tip_post" }, "Body_studio_video_enhance_studio_video_enhance_post": { "properties": { "video": { "type": "string", "format": "binary", "title": "Video" }, "prompt": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Prompt", "default": "Upscale to 4K, stabilize, color grade" } }, "type": "object", "required": [ "video" ], "title": "Body_studio_video_enhance_studio_video_enhance_post" }, "Body_submit_verification_verification_submit_post": { "properties": { "document": { "type": "string", "format": "binary", "title": "Document" }, "selfie": { "type": "string", "format": "binary", "title": "Selfie" }, "doc_type": { "type": "string", "title": "Doc Type", "default": "passport" } }, "type": "object", "required": [ "document", "selfie" ], "title": "Body_submit_verification_verification_submit_post" }, "Body_update_reel_reels__reel_id__put": { "properties": { "caption": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Caption" }, "tags": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Tags" } }, "type": "object", "title": "Body_update_reel_reels__reel_id__put" }, "Body_upload_avatar_profiles_me_avatar_post": { "properties": { "file": { "type": "string", "format": "binary", "title": "File" } }, "type": "object", "required": [ "file" ], "title": "Body_upload_avatar_profiles_me_avatar_post" }, "Body_upload_banner_profiles_me_banner_post": { "properties": { "file": { "type": "string", "format": "binary", "title": "File" } }, "type": "object", "required": [ "file" ], "title": "Body_upload_banner_profiles_me_banner_post" }, "Body_upload_gallery_image_profiles_me_gallery_post": { "properties": { "file": { "type": "string", "format": "binary", "title": "File" } }, "type": "object", "required": [ "file" ], "title": "Body_upload_gallery_image_profiles_me_gallery_post" }, "Body_upload_image_products_upload_image_post": { "properties": { "file": { "type": "string", "format": "binary", "title": "File" } }, "type": "object", "required": [ "file" ], "title": "Body_upload_image_products_upload_image_post" }, "Body_upload_media_media_upload_post": { "properties": { "file": { "type": "string", "format": "binary", "title": "File" } }, "type": "object", "required": [ "file" ], "title": "Body_upload_media_media_upload_post" }, "Body_upload_reel_reels_upload_post": { "properties": { "video": { "type": "string", "format": "binary", "title": "Video" }, "thumbnail": { "anyOf": [ { "type": "string", "format": "binary" }, { "type": "null" } ], "title": "Thumbnail" }, "caption": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Caption" }, "tags": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Tags" } }, "type": "object", "required": [ "video" ], "title": "Body_upload_reel_reels_upload_post" }, "Body_upload_training_file_digital_twin_upload_document_post": { "properties": { "file": { "type": "string", "format": "binary", "title": "File" }, "doc_type": { "type": "string", "title": "Doc Type" } }, "type": "object", "required": [ "file", "doc_type" ], "title": "Body_upload_training_file_digital_twin_upload_document_post" }, "Body_upload_video_products_upload_video_post": { "properties": { "file": { "type": "string", "format": "binary", "title": "File" } }, "type": "object", "required": [ "file" ], "title": "Body_upload_video_products_upload_video_post" }, "Booking": { "properties": { "id": { "type": "string", "title": "Id" }, "client_id": { "type": "string", "title": "Client Id" }, "provider_id": { "type": "string", "title": "Provider Id" }, "service_name": { "type": "string", "title": "Service Name" }, "start_time": { "type": "string", "format": "date-time", "title": "Start Time" }, "end_time": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "End Time" }, "duration_minutes": { "type": "integer", "title": "Duration Minutes" }, "price": { "type": "number", "title": "Price" }, "currency": { "type": "string", "title": "Currency", "default": "EUR" }, "location": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Location" }, "notes": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Notes" }, "status": { "$ref": "#/components/schemas/BookingStatus", "default": "PENDING" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "updated_at": { "type": "string", "format": "date-time", "title": "Updated At" }, "expires_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Expires At" }, "escrow_tx_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Escrow Tx Id" }, "dispute_reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Dispute Reason" }, "meeting_link": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Meeting Link" } }, "type": "object", "required": [ "id", "client_id", "provider_id", "service_name", "start_time", "duration_minutes", "price" ], "title": "Booking" }, "BookingCreate": { "properties": { "provider_id": { "type": "string", "title": "Provider Id" }, "service_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Service Id" }, "service_name": { "type": "string", "title": "Service Name" }, "start_time": { "type": "string", "format": "date-time", "title": "Start Time" }, "duration_minutes": { "type": "integer", "title": "Duration Minutes" }, "price": { "type": "number", "title": "Price" }, "currency": { "type": "string", "title": "Currency", "default": "EUR" }, "location": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Location" }, "notes": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Notes" } }, "type": "object", "required": [ "provider_id", "service_name", "start_time", "duration_minutes", "price" ], "title": "BookingCreate" }, "BookingStatus": { "type": "string", "enum": [ "PENDING", "ACCEPTED", "CONFIRMED", "REJECTED", "COMPLETED", "CANCELLED", "DISPUTED" ], "title": "BookingStatus" }, "BookingStatusUpdate": { "properties": { "status": { "$ref": "#/components/schemas/BookingStatus" }, "dispute_reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Dispute Reason" } }, "type": "object", "required": [ "status" ], "title": "BookingStatusUpdate" }, "BoostRequest": { "properties": { "profile_id": { "type": "string", "title": "Profile Id" }, "duration_hours": { "type": "integer", "title": "Duration Hours" }, "multiplier": { "type": "number", "title": "Multiplier", "default": 1.0 } }, "type": "object", "required": [ "profile_id", "duration_hours" ], "title": "BoostRequest" }, "BoostSimulationRequest": { "properties": { "user_ref": { "type": "string", "title": "User Ref" }, "duration_hours": { "type": "integer", "maximum": 168.0, "minimum": 1.0, "title": "Duration Hours", "default": 24 }, "multiplier": { "type": "number", "maximum": 5.0, "minimum": 1.0, "title": "Multiplier", "default": 1.0 } }, "type": "object", "required": [ "user_ref" ], "title": "BoostSimulationRequest" }, "BreastSize": { "type": "string", "enum": [ "FLAT", "AA", "A", "B", "C", "D", "DD", "E", "F", "F_PLUS", "G_PLUS", "NATURAL", "ENHANCED" ], "title": "BreastSize" }, "BundleDeal": { "properties": { "min_quantity": { "type": "integer", "title": "Min Quantity" }, "discount_percentage": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Discount Percentage" }, "fixed_price": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Fixed Price" } }, "type": "object", "required": [ "min_quantity" ], "title": "BundleDeal" }, "Call": { "properties": { "_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Id" }, "caller_id": { "type": "string", "title": "Caller Id" }, "receiver_id": { "type": "string", "title": "Receiver Id" }, "type": { "$ref": "#/components/schemas/CallType", "default": "VIDEO" }, "status": { "$ref": "#/components/schemas/CallStatus", "default": "INITIATING" }, "room_id": { "type": "string", "title": "Room Id" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "ended_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Ended At" } }, "type": "object", "required": [ "caller_id", "receiver_id", "room_id" ], "title": "Call" }, "CallStatus": { "type": "string", "enum": [ "INITIATING", "ACCEPTED", "ENDED", "REJECTED" ], "title": "CallStatus" }, "CallType": { "type": "string", "enum": [ "VOICE", "VIDEO" ], "title": "CallType" }, "Capabilities": { "properties": { "offers_real": { "type": "boolean", "title": "Offers Real", "default": false }, "offers_virtual": { "type": "boolean", "title": "Offers Virtual", "default": false }, "offers_digital": { "type": "boolean", "title": "Offers Digital", "default": false }, "offers_live_stream": { "type": "boolean", "title": "Offers Live Stream", "default": false }, "offers_marketplace": { "type": "boolean", "title": "Offers Marketplace", "default": false } }, "type": "object", "title": "Capabilities" }, "ChatMessage": { "properties": { "role": { "type": "string", "title": "Role" }, "content": { "anyOf": [ { "type": "string" }, { "items": { "additionalProperties": true, "type": "object" }, "type": "array" } ], "title": "Content" } }, "type": "object", "required": [ "role", "content" ], "title": "ChatMessage" }, "ChatRequest": { "properties": { "messages": { "items": { "$ref": "#/components/schemas/ChatMessage" }, "type": "array", "title": "Messages" }, "model": { "type": "string", "title": "Model", "default": "llama2-uncensored" }, "temperature": { "type": "number", "title": "Temperature", "default": 0.7 }, "max_tokens": { "type": "integer", "title": "Max Tokens", "default": 500 }, "use_runpod": { "type": "boolean", "title": "Use Runpod", "default": false }, "system_prompt": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "System Prompt" }, "user_role": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "User Role", "default": "GUEST" }, "is_pro": { "type": "boolean", "title": "Is Pro", "default": false }, "conversation_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Conversation Id" }, "user_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "User Id" }, "enable_critic": { "type": "boolean", "title": "Enable Critic", "default": false }, "content_domain": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Content Domain" }, "route_path": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Route Path" } }, "type": "object", "required": [ "messages" ], "title": "ChatRequest" }, "ChatResponse": { "properties": { "content": { "type": "string", "title": "Content" }, "model": { "type": "string", "title": "Model" }, "usage": { "anyOf": [ { "additionalProperties": { "type": "integer" }, "type": "object" }, { "type": "null" } ], "title": "Usage" }, "role": { "type": "string", "title": "Role", "default": "assistant" }, "id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Id" }, "created_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Created At" } }, "type": "object", "required": [ "content", "model" ], "title": "ChatResponse" }, "ChatTwinRequest": { "properties": { "message": { "type": "string", "title": "Message" } }, "type": "object", "required": [ "message" ], "title": "ChatTwinRequest" }, "ClaimRequest": { "properties": { "profile_id": { "type": "string", "title": "Profile Id" }, "verification_method": { "type": "string", "title": "Verification Method" }, "proof_data": { "type": "string", "title": "Proof Data" } }, "type": "object", "required": [ "profile_id", "verification_method", "proof_data" ], "title": "ClaimRequest" }, "ClaimStatus": { "type": "string", "enum": [ "unclaimed", "claimed", "verified" ], "title": "ClaimStatus" }, "Conversation": { "properties": { "_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Id" }, "participants": { "items": { "type": "string" }, "type": "array", "title": "Participants" }, "last_message": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Last Message" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "updated_at": { "type": "string", "format": "date-time", "title": "Updated At" } }, "type": "object", "required": [ "participants" ], "title": "Conversation" }, "CopyrightEvidence": { "properties": { "discovery_hash": { "type": "string", "title": "Discovery Hash", "description": "SHA-256 hash of the content or profile snapshot" }, "discovery_timestamp": { "type": "string", "format": "date-time", "title": "Discovery Timestamp" }, "source_url": { "type": "string", "title": "Source Url" }, "raw_metadata_snapshot": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Raw Metadata Snapshot" }, "blockchain_tx_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Blockchain Tx Id", "description": "IOTA Rebased transaction ID for timestamp proof" }, "watermark_detected": { "type": "boolean", "title": "Watermark Detected", "default": false }, "original_creator_hint": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Original Creator Hint" } }, "type": "object", "required": [ "discovery_hash", "source_url" ], "title": "CopyrightEvidence", "description": "Legal proof of discovery and content existence.\nUsed for copyright claims and IOTA timestamping." }, "CryptoVerificationRequest": { "properties": { "tx_hash": { "type": "string", "title": "Tx Hash" }, "order_id": { "type": "string", "title": "Order Id" } }, "type": "object", "required": [ "tx_hash", "order_id" ], "title": "CryptoVerificationRequest" }, "DMCAClaim": { "properties": { "_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Id" }, "user_id": { "type": "string", "title": "User Id" }, "target_url": { "type": "string", "title": "Target Url" }, "original_content_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Original Content Url" }, "status": { "$ref": "#/components/schemas/DMCAStatus", "default": "PENDING" }, "evidence_hash": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Evidence Hash" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "updated_at": { "type": "string", "format": "date-time", "title": "Updated At" }, "platform": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Platform" }, "notes": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Notes" } }, "type": "object", "required": [ "user_id", "target_url" ], "title": "DMCAClaim" }, "DMCAStatus": { "type": "string", "enum": [ "PENDING", "SENT", "COMPLETED", "FAILED" ], "title": "DMCAStatus" }, "DashboardResponse": { "properties": { "layout": { "type": "string", "title": "Layout" }, "widgets": { "items": { "$ref": "#/components/schemas/DashboardWidget" }, "type": "array", "title": "Widgets" }, "notifications": { "type": "integer", "title": "Notifications", "default": 0 } }, "type": "object", "required": [ "layout", "widgets" ], "title": "DashboardResponse" }, "DashboardStatsResponse": { "properties": { "balance": { "type": "number", "title": "Balance" }, "total_bookings": { "type": "integer", "title": "Total Bookings" }, "pending_bookings": { "type": "integer", "title": "Pending Bookings" }, "profile_views": { "type": "integer", "title": "Profile Views" }, "wishlist_count": { "type": "integer", "title": "Wishlist Count", "default": 0 }, "earnings_total": { "type": "number", "title": "Earnings Total", "default": 0.0 }, "conversion_rate": { "type": "number", "title": "Conversion Rate", "default": 0.0 }, "total_sales": { "type": "integer", "title": "Total Sales", "default": 0 }, "total_products": { "type": "integer", "title": "Total Products", "default": 0 }, "pending_orders": { "type": "integer", "title": "Pending Orders", "default": 0 }, "copyright_proofs_count": { "type": "integer", "title": "Copyright Proofs Count", "default": 0 } }, "type": "object", "required": [ "balance", "total_bookings", "pending_bookings", "profile_views" ], "title": "DashboardStatsResponse" }, "DashboardWidget": { "properties": { "id": { "type": "string", "title": "Id" }, "type": { "type": "string", "title": "Type" }, "title": { "type": "string", "title": "Title" }, "data": { "additionalProperties": true, "type": "object", "title": "Data" }, "layout": { "additionalProperties": { "type": "integer" }, "type": "object", "title": "Layout" } }, "type": "object", "required": [ "id", "type", "title", "data", "layout" ], "title": "DashboardWidget" }, "DigitalTwinState": { "properties": { "user_id": { "type": "string", "title": "User Id" }, "last_updated": { "type": "string", "format": "date-time", "title": "Last Updated" }, "profile_summary": { "additionalProperties": true, "type": "object", "title": "Profile Summary" }, "interaction_style": { "$ref": "#/components/schemas/InteractionStyle" }, "sales_metrics": { "$ref": "#/components/schemas/SalesMetrics" }, "active_agents": { "items": { "$ref": "#/components/schemas/TwinAgentStatus" }, "type": "array", "title": "Active Agents" }, "knowledge_base_size": { "type": "integer", "title": "Knowledge Base Size", "default": 0 }, "training_documents": { "items": { "$ref": "#/components/schemas/TwinTrainingDocument" }, "type": "array", "title": "Training Documents", "default": [] }, "sync_status": { "type": "string", "title": "Sync Status", "default": "synced" }, "seo_programmatic_active": { "type": "boolean", "title": "Seo Programmatic Active", "default": false }, "scraped_perils_found": { "type": "integer", "title": "Scraped Perils Found", "default": 0 }, "last_seo_sync": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Last Seo Sync" } }, "type": "object", "required": [ "user_id", "last_updated", "profile_summary", "interaction_style", "sales_metrics", "active_agents" ], "title": "DigitalTwinState" }, "DisputeCreate": { "properties": { "user_id": { "type": "string", "title": "User Id" }, "creator_id": { "type": "string", "title": "Creator Id" }, "reason": { "type": "string", "title": "Reason" }, "description": { "type": "string", "title": "Description" } }, "type": "object", "required": [ "user_id", "creator_id", "reason", "description" ], "title": "DisputeCreate" }, "Ethnicity": { "type": "string", "enum": [ "CAUCASIAN", "WHITE", "LATINO", "LATINA", "BLACK_AFRICAN", "BLACK", "ASIAN", "MIDDLE_EASTERN", "INDIAN", "MIXED", "OTHER" ], "title": "Ethnicity" }, "ExternalSource": { "properties": { "platform": { "type": "string", "title": "Platform" }, "external_id": { "type": "string", "title": "External Id" }, "external_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "External Url" }, "scraped_at": { "type": "string", "format": "date-time", "title": "Scraped At" }, "is_live_now": { "type": "boolean", "title": "Is Live Now", "default": false }, "last_broadcast": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Last Broadcast" } }, "type": "object", "required": [ "platform", "external_id" ], "title": "ExternalSource" }, "EyeColor": { "type": "string", "enum": [ "BLUE", "BROWN", "GREEN", "HAZEL", "GREY", "AMBER", "BLACK", "OTHER" ], "title": "EyeColor" }, "FeatureID": { "type": "string", "enum": [ "BASIC_SEARCH", "ADVANCED_SEARCH", "VERIFIED_ONLY_ACCESS", "INCOGNITO_MODE", "ANALYTICS_BASIC", "ANALYTICS_DETAILED", "PROFILE_BOOST", "UNLIMITED_UPLOADS", "CUSTOM_THEMES", "LIVE_STREAM", "REELS_UPLOAD", "STORAGE_DRIVE_EXTENDED", "CHATBOT_AUTOMATION", "AI_IMAGE_GENERATION", "AI_CHAT_ASSIST", "COPYRIGHT_UTILITIES", "API_ACCESS", "SCRAPER_ACCESS" ], "title": "FeatureID" }, "FeatureStatus": { "properties": { "id": { "$ref": "#/components/schemas/FeatureID" }, "allowed": { "type": "boolean", "title": "Allowed" }, "locked": { "type": "boolean", "title": "Locked" }, "cta": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Cta" } }, "type": "object", "required": [ "id", "allowed", "locked" ], "title": "FeatureStatus" }, "FeaturesResponse": { "properties": { "audience": { "type": "string", "title": "Audience" }, "features": { "items": { "$ref": "#/components/schemas/FeatureStatus" }, "type": "array", "title": "Features" } }, "type": "object", "required": [ "audience", "features" ], "title": "FeaturesResponse" }, "ForgotPasswordRequest": { "properties": { "email": { "type": "string", "format": "email", "title": "Email" } }, "type": "object", "required": [ "email" ], "title": "ForgotPasswordRequest" }, "ForgotPasswordResponse": { "properties": { "success": { "type": "boolean", "title": "Success" }, "reset_token": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Reset Token" }, "reset_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Reset Url" } }, "type": "object", "required": [ "success" ], "title": "ForgotPasswordResponse" }, "Gamification": { "properties": { "last_spin": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Last Spin" }, "spin_count": { "type": "integer", "title": "Spin Count", "default": 0 }, "badges": { "items": { "type": "string" }, "type": "array", "title": "Badges" } }, "type": "object", "title": "Gamification" }, "Gender": { "type": "string", "enum": [ "FEMALE", "MALE", "TRANS_FEMALE", "TRANS_MALE", "NON_BINARY" ], "title": "Gender" }, "GenerateImageRequest": { "properties": { "prompt": { "type": "string", "title": "Prompt" }, "width": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Width", "default": 512 }, "height": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Height", "default": 768 }, "steps": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Steps", "default": 30 }, "init_image": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Init Image" }, "strength": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Strength", "default": 0.7 } }, "type": "object", "required": [ "prompt" ], "title": "GenerateImageRequest" }, "GenerateVideoRequest": { "properties": { "prompt": { "type": "string", "title": "Prompt" }, "duration": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Duration", "default": 4 }, "width": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Width", "default": 768 }, "height": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Height", "default": 1024 } }, "type": "object", "required": [ "prompt" ], "title": "GenerateVideoRequest" }, "GeoLocation": { "properties": { "lat": { "type": "number", "title": "Lat" }, "lng": { "type": "number", "title": "Lng" } }, "type": "object", "required": [ "lat", "lng" ], "title": "GeoLocation" }, "GlobalStatsResponse": { "properties": { "active_users": { "type": "integer", "title": "Active Users" }, "total_creators": { "type": "integer", "title": "Total Creators" }, "uptime_percentage": { "type": "number", "title": "Uptime Percentage", "default": 100.0 } }, "type": "object", "required": [ "active_users", "total_creators" ], "title": "GlobalStatsResponse" }, "HTTPValidationError": { "properties": { "detail": { "items": { "$ref": "#/components/schemas/ValidationError" }, "type": "array", "title": "Detail" } }, "type": "object", "title": "HTTPValidationError" }, "HairColor": { "type": "string", "enum": [ "BLONDE", "BRUNETTE", "BLACK", "RED", "AUBURN", "GREY", "WHITE", "BALD", "COLORED", "BLUE", "PINK", "PURPLE", "OTHER" ], "title": "HairColor" }, "IdentityAttributes": { "properties": { "gender": { "anyOf": [ { "$ref": "#/components/schemas/Gender" }, { "type": "null" } ] }, "orientation": { "anyOf": [ { "$ref": "#/components/schemas/Orientation" }, { "type": "null" } ] }, "languages": { "items": { "type": "string" }, "type": "array", "title": "Languages" }, "nationality": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Nationality" }, "zodiac_sign": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Zodiac Sign" }, "travel_ready": { "type": "boolean", "title": "Travel Ready", "default": false }, "incall": { "type": "boolean", "title": "Incall", "default": false }, "outcall": { "type": "boolean", "title": "Outcall", "default": false } }, "type": "object", "title": "IdentityAttributes" }, "InitiateCallRequest": { "properties": { "receiver_id": { "type": "string", "title": "Receiver Id" }, "call_type": { "$ref": "#/components/schemas/CallType", "default": "VIDEO" }, "price_per_minute": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Price Per Minute" } }, "type": "object", "required": [ "receiver_id" ], "title": "InitiateCallRequest" }, "InteractionStyle": { "properties": { "tone": { "type": "string", "title": "Tone", "default": "neutral" }, "avg_response_length": { "type": "integer", "title": "Avg Response Length", "default": 0 }, "keywords": { "items": { "type": "string" }, "type": "array", "title": "Keywords", "default": [] }, "emoji_usage": { "type": "number", "title": "Emoji Usage", "default": 0.0 } }, "type": "object", "title": "InteractionStyle" }, "Level": { "properties": { "current": { "type": "integer", "title": "Current", "default": 1 }, "xp": { "type": "integer", "title": "Xp", "default": 0 } }, "type": "object", "title": "Level" }, "MarketRates": { "properties": { "average_price": { "type": "number", "title": "Average Price" }, "min_price": { "type": "number", "title": "Min Price" }, "max_price": { "type": "number", "title": "Max Price" }, "demand_level": { "type": "string", "title": "Demand Level" }, "active_listings": { "type": "integer", "title": "Active Listings" }, "trending_category": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Trending Category" } }, "type": "object", "required": [ "average_price", "min_price", "max_price", "demand_level", "active_listings" ], "title": "MarketRates" }, "MarketplaceOffer": { "properties": { "id": { "type": "string", "title": "Id" }, "request_id": { "type": "string", "title": "Request Id" }, "provider_id": { "type": "string", "title": "Provider Id" }, "amount": { "type": "number", "title": "Amount" }, "currency": { "type": "string", "title": "Currency", "default": "USD" }, "message": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Message" }, "status": { "type": "string", "title": "Status", "default": "PENDING" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "updated_at": { "type": "string", "format": "date-time", "title": "Updated At" }, "completed_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Completed At" }, "escrow_tx_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Escrow Tx Id" }, "settlement_tx_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Settlement Tx Id" } }, "type": "object", "required": [ "id", "request_id", "provider_id", "amount" ], "title": "MarketplaceOffer" }, "MarketplaceRequest": { "properties": { "id": { "type": "string", "title": "Id" }, "requester_id": { "type": "string", "title": "Requester Id" }, "title": { "type": "string", "title": "Title" }, "description": { "type": "string", "title": "Description" }, "budget": { "type": "number", "title": "Budget" }, "status": { "$ref": "#/components/schemas/RequestStatus", "default": "OPEN" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "category": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Category" }, "tags": { "items": { "type": "string" }, "type": "array", "title": "Tags" } }, "type": "object", "required": [ "id", "requester_id", "title", "description", "budget" ], "title": "MarketplaceRequest" }, "MarketplaceRequestCreate": { "properties": { "title": { "type": "string", "title": "Title" }, "description": { "type": "string", "title": "Description" }, "budget": { "type": "number", "title": "Budget" }, "category": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Category" }, "tags": { "items": { "type": "string" }, "type": "array", "title": "Tags" } }, "type": "object", "required": [ "title", "description", "budget" ], "title": "MarketplaceRequestCreate" }, "Message": { "properties": { "_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Id" }, "conversation_id": { "type": "string", "title": "Conversation Id" }, "sender_id": { "type": "string", "title": "Sender Id" }, "recipient_id": { "type": "string", "title": "Recipient Id" }, "content": { "type": "string", "title": "Content" }, "type": { "$ref": "#/components/schemas/MessageType", "default": "text" }, "status": { "$ref": "#/components/schemas/MessageStatus", "default": "sent" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "attachment_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Attachment Url" }, "thumbnail_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Thumbnail Url" }, "mime_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Mime Type" }, "file_size": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "File Size" }, "price": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Price" }, "is_locked": { "type": "boolean", "title": "Is Locked", "default": false }, "unlocked_by": { "items": { "type": "string" }, "type": "array", "title": "Unlocked By" }, "metadata": { "additionalProperties": true, "type": "object", "title": "Metadata" } }, "type": "object", "required": [ "conversation_id", "sender_id", "recipient_id", "content" ], "title": "Message" }, "MessageStatus": { "type": "string", "enum": [ "sent", "delivered", "read", "failed" ], "title": "MessageStatus" }, "MessageType": { "type": "string", "enum": [ "text", "image", "video", "audio", "file", "ppv", "tip" ], "title": "MessageType" }, "AnchorRequest": { "properties": { "media_id": { "type": "string", "title": "Media Id" }, "media_type": { "type": "string", "title": "Media Type" }, "title": { "type": "string", "title": "Title" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description" } }, "type": "object", "required": [ "media_id", "media_type", "title" ], "title": "AnchorRequest" }, "ModerationRequest": { "properties": { "text": { "type": "string", "title": "Text" }, "context": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Context" } }, "type": "object", "required": [ "text" ], "title": "ModerationRequest" }, "ModerationResponse": { "properties": { "is_safe": { "type": "boolean", "title": "Is Safe" }, "flagged_categories": { "items": { "type": "string" }, "type": "array", "title": "Flagged Categories" }, "confidence_score": { "type": "number", "title": "Confidence Score", "default": 0.0 } }, "type": "object", "required": [ "is_safe" ], "title": "ModerationResponse" }, "ModuleAction": { "type": "string", "enum": [ "activate", "pause", "hide" ], "title": "ModuleAction" }, "ModuleSettings": { "properties": { "is_active": { "type": "boolean", "title": "Is Active", "default": false }, "is_hidden": { "type": "boolean", "title": "Is Hidden", "default": false }, "custom_settings": { "additionalProperties": true, "type": "object", "title": "Custom Settings" } }, "type": "object", "title": "ModuleSettings" }, "ModuleToggleRequest": { "properties": { "module_id": { "type": "string", "title": "Module Id" }, "action": { "$ref": "#/components/schemas/ModuleAction" } }, "type": "object", "required": [ "module_id", "action" ], "title": "ModuleToggleRequest" }, "NormalizeAmountRequest": { "properties": { "amount": { "type": "number", "exclusiveMinimum": 0.0, "title": "Amount" }, "source_currency": { "type": "string", "title": "Source Currency" }, "target_currency": { "type": "string", "title": "Target Currency", "default": "USD" } }, "type": "object", "required": [ "amount", "source_currency" ], "title": "NormalizeAmountRequest" }, "Offer": { "properties": { "id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Id" }, "user_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "User Id" }, "type": { "$ref": "#/components/schemas/OfferType" }, "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Title" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description" }, "price": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Price" }, "currency": { "type": "string", "title": "Currency", "default": "EUR" }, "duration_minutes": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Duration Minutes" }, "is_active": { "type": "boolean", "title": "Is Active", "default": true }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "updated_at": { "type": "string", "format": "date-time", "title": "Updated At" } }, "type": "object", "required": [ "type" ], "title": "Offer" }, "OfferType": { "type": "string", "enum": [ "REAL", "VIRTUAL", "DIGITAL", "LIVE", "MARKETPLACE" ], "title": "OfferType" }, "OracleResponse": { "properties": { "reading": { "type": "string", "title": "Reading" } }, "type": "object", "required": [ "reading" ], "title": "OracleResponse" }, "OrderItem": { "properties": { "id": { "type": "string", "title": "Id" }, "product_id": { "type": "string", "title": "Product Id" }, "product_title": { "type": "string", "title": "Product Title" }, "product_type": { "type": "string", "title": "Product Type" }, "quantity": { "type": "integer", "title": "Quantity" }, "price": { "type": "number", "title": "Price" }, "currency": { "type": "string", "title": "Currency" }, "media_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Media Url" } }, "type": "object", "required": [ "id", "product_id", "product_title", "product_type", "quantity", "price", "currency" ], "title": "OrderItem" }, "Orientation": { "type": "string", "enum": [ "STRAIGHT", "BISEXUAL", "GAY", "LESBIAN" ], "title": "Orientation" }, "OriginSource": { "type": "string", "enum": [ "ORGANIC", "AFFILIATE", "IMPORT", "SCRAPED" ], "title": "OriginSource" }, "PhysicalAttributes": { "properties": { "age": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Age" }, "height": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Height" }, "weight": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Weight" }, "hair_color": { "anyOf": [ { "$ref": "#/components/schemas/HairColor" }, { "type": "null" } ] }, "eye_color": { "anyOf": [ { "$ref": "#/components/schemas/EyeColor" }, { "type": "null" } ] }, "ethnicity": { "anyOf": [ { "$ref": "#/components/schemas/Ethnicity" }, { "type": "null" } ] }, "body_type": { "anyOf": [ { "$ref": "#/components/schemas/BodyType" }, { "type": "null" } ] }, "tattoos": { "type": "boolean", "title": "Tattoos", "default": false }, "piercings": { "type": "boolean", "title": "Piercings", "default": false }, "breast_size": { "anyOf": [ { "$ref": "#/components/schemas/BreastSize" }, { "type": "null" } ] }, "measurements": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Measurements" }, "smoking": { "anyOf": [ { "$ref": "#/components/schemas/Smoking" }, { "type": "null" } ] }, "pubic_hair": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Pubic Hair" } }, "type": "object", "title": "PhysicalAttributes" }, "PinnyProTier": { "type": "string", "enum": [ "NONE", "CLIENT_PRO", "PROVIDER_PRO", "ULTIMATE" ], "title": "PinnyProTier" }, "Product": { "properties": { "id": { "type": "string", "title": "Id" }, "creator_id": { "type": "string", "title": "Creator Id" }, "title": { "type": "string", "title": "Title" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description" }, "price": { "type": "number", "title": "Price" }, "currency": { "type": "string", "title": "Currency", "default": "USD" }, "type": { "$ref": "#/components/schemas/ProductType", "default": "CONTENT" }, "tier": { "$ref": "#/components/schemas/ProductTier", "default": "SILVER" }, "is_free": { "type": "boolean", "title": "Is Free", "default": false }, "is_anchored": { "type": "boolean", "title": "Is Anchored", "default": false }, "content_hash": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Content Hash" }, "anchoring_metadata": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Anchoring Metadata" }, "media_urls": { "items": { "type": "string" }, "type": "array", "title": "Media Urls" }, "file_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "File Url" }, "shipping_cost": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Shipping Cost" }, "video_metadata": { "anyOf": [ { "$ref": "#/components/schemas/VideoMetadata" }, { "type": "null" } ] }, "bundle_deals": { "items": { "$ref": "#/components/schemas/BundleDeal" }, "type": "array", "title": "Bundle Deals" }, "status": { "type": "string", "title": "Status", "default": "active" }, "retention_expiry": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Retention Expiry" }, "size_bytes": { "type": "integer", "title": "Size Bytes", "default": 0 }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "sales_count": { "type": "integer", "title": "Sales Count", "default": 0 }, "rating": { "type": "number", "title": "Rating", "default": 0.0 } }, "type": "object", "required": [ "id", "creator_id", "title", "price" ], "title": "Product" }, "ProductCreate": { "properties": { "title": { "type": "string", "title": "Title" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description" }, "price": { "type": "number", "title": "Price", "default": 0.0 }, "currency": { "type": "string", "title": "Currency", "default": "USD" }, "type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Type", "default": "CONTENT" }, "tier": { "$ref": "#/components/schemas/ProductTier", "default": "SILVER" }, "is_free": { "type": "boolean", "title": "Is Free", "default": false }, "is_anchored": { "type": "boolean", "title": "Is Anchored", "default": false }, "content_hash": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Content Hash" }, "license_type": { "type": "string", "title": "License Type", "default": "standard_personal" }, "media_urls": { "items": { "type": "string" }, "type": "array", "title": "Media Urls" }, "file_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "File Url" }, "size_bytes": { "type": "integer", "title": "Size Bytes", "default": 0 }, "shipping_cost": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Shipping Cost" }, "video_metadata": { "anyOf": [ { "$ref": "#/components/schemas/VideoMetadata" }, { "type": "null" } ] }, "bundle_deals": { "items": { "$ref": "#/components/schemas/BundleDeal" }, "type": "array", "title": "Bundle Deals" } }, "type": "object", "required": [ "title" ], "title": "ProductCreate" }, "ProductTier": { "type": "string", "enum": [ "BRONZE", "SILVER", "GOLD", "PLATINUM" ], "title": "ProductTier" }, "ProductType": { "type": "string", "enum": [ "CONTENT", "PHYSICAL", "DIGITAL", "SERVICE", "MOVIE", "PROTECTED", "MEDIA" ], "title": "ProductType" }, "ProfileStatus": { "type": "string", "enum": [ "ACTIVE", "UNCLAIMED", "PENDING_RECLAIM", "SUSPENDED" ], "title": "ProfileStatus" }, "ProfileType": { "type": "string", "enum": [ "user", "claimable" ], "title": "ProfileType" }, "RecycleRequest": { "properties": { "title": { "type": "string", "title": "Title" }, "description": { "type": "string", "title": "Description" }, "tags": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Tags", "default": [] } }, "type": "object", "required": [ "title", "description" ], "title": "RecycleRequest" }, "Reel": { "properties": { "id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Id" }, "user_id": { "type": "string", "title": "User Id" }, "username": { "type": "string", "title": "Username" }, "creator_avatar": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Creator Avatar" }, "video_url": { "type": "string", "title": "Video Url" }, "hls_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Hls Url" }, "thumbnail_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Thumbnail Url" }, "content_hash": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Content Hash" }, "caption": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Caption" }, "tags": { "items": { "type": "string" }, "type": "array", "title": "Tags" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "views_count": { "type": "integer", "title": "Views Count", "default": 0 }, "likes_count": { "type": "integer", "title": "Likes Count", "default": 0 }, "is_verified": { "type": "boolean", "title": "Is Verified", "default": false }, "is_boosted": { "type": "boolean", "title": "Is Boosted", "default": false }, "boost_expiry": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Boost Expiry" }, "is_exclusive": { "type": "boolean", "title": "Is Exclusive", "default": false }, "required_tier": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Required Tier" }, "status": { "type": "string", "title": "Status", "default": "active" }, "retention_expiry": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Retention Expiry" }, "size_bytes": { "type": "integer", "title": "Size Bytes", "default": 0 } }, "type": "object", "required": [ "user_id", "username", "video_url" ], "title": "Reel" }, "RefreshResponse": { "properties": { "access_token": { "type": "string", "title": "Access Token" }, "token_type": { "type": "string", "title": "Token Type", "default": "bearer" }, "expires_in": { "type": "integer", "title": "Expires In" }, "user": { "additionalProperties": true, "type": "object", "title": "User" } }, "type": "object", "required": [ "access_token", "expires_in", "user" ], "title": "RefreshResponse" }, "RequestStatus": { "type": "string", "enum": [ "OPEN", "IN_PROGRESS", "COMPLETED", "CANCELLED" ], "title": "RequestStatus" }, "ResetPasswordRequest": { "properties": { "email": { "type": "string", "format": "email", "title": "Email" }, "token": { "type": "string", "title": "Token" }, "password": { "type": "string", "title": "Password" } }, "type": "object", "required": [ "email", "token", "password" ], "title": "ResetPasswordRequest" }, "RevenueDataPoint": { "properties": { "date": { "type": "string", "title": "Date" }, "value": { "type": "number", "title": "Value" } }, "type": "object", "required": [ "date", "value" ], "title": "RevenueDataPoint" }, "Review": { "properties": { "id": { "type": "string", "title": "Id" }, "author_id": { "type": "string", "title": "Author Id" }, "target_id": { "type": "string", "title": "Target Id" }, "rating": { "type": "integer", "maximum": 5.0, "minimum": 1.0, "title": "Rating" }, "content": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Content" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "is_verified": { "type": "boolean", "title": "Is Verified", "default": false }, "reviewer": { "anyOf": [ { "$ref": "#/components/schemas/ReviewerInfo" }, { "type": "null" } ] } }, "type": "object", "required": [ "id", "author_id", "target_id", "rating" ], "title": "Review" }, "ReviewCreate": { "properties": { "target_id": { "type": "string", "title": "Target Id" }, "rating": { "type": "integer", "maximum": 5.0, "minimum": 1.0, "title": "Rating" }, "content": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Content" } }, "type": "object", "required": [ "target_id", "rating" ], "title": "ReviewCreate" }, "ReviewerInfo": { "properties": { "id": { "type": "string", "title": "Id" }, "username": { "type": "string", "title": "Username" }, "avatar_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Avatar Url" }, "display_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Display Name" } }, "type": "object", "required": [ "id", "username" ], "title": "ReviewerInfo" }, "RoleUpdate": { "properties": { "role": { "$ref": "#/components/schemas/UserRole" } }, "type": "object", "required": [ "role" ], "title": "RoleUpdate" }, "SafetyRegisterRequest": { "properties": { "content_hash": { "type": "string", "title": "Content Hash" }, "metadata": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Metadata", "default": {} } }, "type": "object", "required": [ "content_hash" ], "title": "SafetyRegisterRequest" }, "SafetyTimerCreate": { "properties": { "check_in_minutes": { "type": "integer", "title": "Check In Minutes", "default": 60 }, "emergency_minutes": { "type": "integer", "title": "Emergency Minutes", "default": 120 }, "location": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Location" }, "emergency_contact": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Emergency Contact" }, "notes": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Notes" } }, "type": "object", "title": "SafetyTimerCreate" }, "SafetyTimerResponse": { "properties": { "id": { "type": "string", "title": "Id" }, "user_id": { "type": "string", "title": "User Id" }, "status": { "type": "string", "title": "Status" }, "check_in_at": { "type": "string", "format": "date-time", "title": "Check In At" }, "emergency_at": { "type": "string", "format": "date-time", "title": "Emergency At" }, "location": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Location" }, "emergency_contact": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Emergency Contact" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" } }, "type": "object", "required": [ "id", "user_id", "status", "check_in_at", "emergency_at", "location", "emergency_contact", "created_at" ], "title": "SafetyTimerResponse" }, "SalesMetrics": { "properties": { "total_revenue": { "type": "number", "title": "Total Revenue", "default": 0.0 }, "sales_count": { "type": "integer", "title": "Sales Count", "default": 0 }, "top_products": { "items": { "type": "string" }, "type": "array", "title": "Top Products", "default": [] }, "conversion_rate": { "type": "number", "title": "Conversion Rate", "default": 0.0 } }, "type": "object", "title": "SalesMetrics" }, "ScanRequest": { "properties": { "url": { "type": "string", "title": "Url" } }, "type": "object", "required": [ "url" ], "title": "ScanRequest" }, "SecuritySettings": { "properties": { "two_factor_enabled": { "type": "boolean", "title": "Two Factor Enabled", "default": false }, "last_password_change": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Last Password Change" } }, "type": "object", "title": "SecuritySettings" }, "SendMessageRequest": { "properties": { "recipient_id": { "type": "string", "title": "Recipient Id" }, "content": { "type": "string", "title": "Content" }, "type": { "$ref": "#/components/schemas/MessageType", "default": "text" }, "attachment_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Attachment Url" }, "thumbnail_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Thumbnail Url" }, "price": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Price" }, "is_locked": { "type": "boolean", "title": "Is Locked", "default": false }, "metadata": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Metadata" } }, "type": "object", "required": [ "recipient_id", "content" ], "title": "SendMessageRequest" }, "ShippingAddress": { "properties": { "name": { "type": "string", "title": "Name" }, "street": { "type": "string", "title": "Street" }, "city": { "type": "string", "title": "City" }, "state": { "type": "string", "title": "State" }, "postal_code": { "type": "string", "title": "Postal Code" }, "country": { "type": "string", "title": "Country" } }, "type": "object", "required": [ "name", "street", "city", "state", "postal_code", "country" ], "title": "ShippingAddress" }, "SmartReplyRequest": { "properties": { "user_id": { "type": "string", "title": "User Id" }, "conversation_context": { "items": { "$ref": "#/components/schemas/ChatMessage" }, "type": "array", "title": "Conversation Context" }, "tone": { "type": "string", "title": "Tone", "default": "flirty" } }, "type": "object", "required": [ "user_id", "conversation_context" ], "title": "SmartReplyRequest" }, "Smoking": { "type": "string", "enum": [ "NON_SMOKER", "SMOKER", "OCCASIONAL", "SOCIALLY", "VAPE" ], "title": "Smoking" }, "SocialAttributes": { "properties": { "twitter": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Twitter" }, "instagram": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Instagram" }, "telegram": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Telegram" }, "whatsapp": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Whatsapp" }, "phone": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Phone" }, "website": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Website" }, "onlyfans": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Onlyfans" }, "fansly": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Fansly" }, "payment_links": { "additionalProperties": { "type": "string" }, "type": "object", "title": "Payment Links" } }, "type": "object", "title": "SocialAttributes" }, "SpinPrize": { "properties": { "type": { "type": "string", "title": "Type" }, "amount": { "type": "integer", "title": "Amount", "default": 0 }, "name": { "type": "string", "title": "Name" }, "description": { "type": "string", "title": "Description" } }, "type": "object", "required": [ "type", "name", "description" ], "title": "SpinPrize" }, "SpinResponse": { "properties": { "prize": { "$ref": "#/components/schemas/SpinPrize" }, "next_spin_at": { "type": "string", "format": "date-time", "title": "Next Spin At" }, "balance_update": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Balance Update" } }, "type": "object", "required": [ "prize", "next_spin_at" ], "title": "SpinResponse" }, "StartStreamRequest": { "properties": { "title": { "type": "string", "title": "Title" }, "category": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Category", "default": "Virtual" }, "tags": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Tags", "default": "" }, "is_private": { "type": "boolean", "title": "Is Private", "default": false }, "price": { "type": "number", "title": "Price", "default": 0.0 }, "price_per_minute": { "type": "number", "title": "Price Per Minute", "default": 0.0 } }, "type": "object", "required": [ "title" ], "title": "StartStreamRequest" }, "StartStreamResponse": { "properties": { "id": { "type": "string", "title": "Id" }, "stream_id": { "type": "string", "title": "Stream Id" }, "stream_key": { "type": "string", "title": "Stream Key" }, "rtmp_url": { "type": "string", "title": "Rtmp Url" }, "hls_url": { "type": "string", "title": "Hls Url" }, "title": { "type": "string", "title": "Title" } }, "type": "object", "required": [ "id", "stream_id", "stream_key", "rtmp_url", "hls_url", "title" ], "title": "StartStreamResponse" }, "StorageDrive": { "properties": { "is_enabled": { "type": "boolean", "title": "Is Enabled", "default": false }, "limit_gb": { "type": "number", "title": "Limit Gb", "default": 0.0 }, "used_gb": { "type": "number", "title": "Used Gb", "default": 0.0 }, "auto_cleanup_enabled": { "type": "boolean", "title": "Auto Cleanup Enabled", "default": true }, "retention_days": { "type": "integer", "title": "Retention Days", "default": 30 } }, "type": "object", "title": "StorageDrive" }, "StoreOrder": { "properties": { "id": { "type": "string", "title": "Id" }, "customer_id": { "type": "string", "title": "Customer Id" }, "customer_name": { "type": "string", "title": "Customer Name" }, "customer_avatar": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Customer Avatar" }, "items": { "items": { "$ref": "#/components/schemas/OrderItem" }, "type": "array", "title": "Items" }, "total_amount": { "type": "number", "title": "Total Amount" }, "currency": { "type": "string", "title": "Currency" }, "status": { "type": "string", "title": "Status" }, "shipping_address": { "anyOf": [ { "$ref": "#/components/schemas/ShippingAddress" }, { "type": "null" } ] }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "updated_at": { "type": "string", "format": "date-time", "title": "Updated At" } }, "type": "object", "required": [ "id", "customer_id", "customer_name", "items", "total_amount", "currency", "status", "created_at", "updated_at" ], "title": "StoreOrder" }, "StoreOrderStatusUpdate": { "properties": { "status": { "type": "string", "title": "Status" } }, "type": "object", "required": [ "status" ], "title": "StoreOrderStatusUpdate" }, "StreamInfo": { "properties": { "id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Id" }, "user_id": { "type": "string", "title": "User Id" }, "username": { "type": "string", "title": "Username" }, "title": { "type": "string", "title": "Title" }, "thumbnail_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Thumbnail Url" }, "viewer_count": { "type": "integer", "title": "Viewer Count", "default": 0 }, "is_live": { "type": "boolean", "title": "Is Live", "default": true }, "started_at": { "type": "string", "format": "date-time", "title": "Started At" }, "hls_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Hls Url" }, "category": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Category" }, "tags": { "items": { "type": "string" }, "type": "array", "title": "Tags" }, "is_private": { "type": "boolean", "title": "Is Private", "default": false }, "price": { "type": "number", "title": "Price", "default": 0.0 }, "price_per_minute": { "type": "number", "title": "Price Per Minute", "default": 0.0 }, "allowed_users": { "items": { "type": "string" }, "type": "array", "title": "Allowed Users" }, "goal_amount": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Goal Amount" }, "current_tips": { "type": "number", "title": "Current Tips", "default": 0.0 }, "goal_title": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Goal Title" } }, "type": "object", "required": [ "user_id", "username", "title" ], "title": "StreamInfo" }, "SubscriptionRequest": { "properties": { "user_id": { "type": "string", "title": "User Id" }, "target_tier": { "$ref": "#/components/schemas/PinnyProTier" }, "duration_months": { "type": "integer", "title": "Duration Months", "default": 1 } }, "type": "object", "required": [ "user_id", "target_tier" ], "title": "SubscriptionRequest" }, "SwipeEvent": { "properties": { "target_id": { "type": "string", "title": "Target Id" }, "direction": { "type": "string", "title": "Direction" }, "context": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Context", "default": "swipe_deck" } }, "type": "object", "required": [ "target_id", "direction" ], "title": "SwipeEvent" }, "SystemConfigEntry": { "properties": { "key": { "type": "string", "title": "Key" }, "value": { "type": "string", "title": "Value" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description" }, "is_secret": { "type": "boolean", "title": "Is Secret", "default": true }, "updated_at": { "type": "string", "format": "date-time", "title": "Updated At" } }, "type": "object", "required": [ "key", "value" ], "title": "SystemConfigEntry" }, "TextGenerationRequest": { "properties": { "prompt": { "type": "string", "title": "Prompt" }, "style": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Style" }, "mode": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Mode", "default": "bio" }, "context": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Context" } }, "type": "object", "required": [ "prompt" ], "title": "TextGenerationRequest" }, "TextGenerationResponse": { "properties": { "text": { "type": "string", "title": "Text" }, "generated_at": { "type": "string", "format": "date-time", "title": "Generated At" } }, "type": "object", "required": [ "text" ], "title": "TextGenerationResponse" }, "TipRequest": { "properties": { "recipient_id": { "type": "string", "title": "Recipient Id" }, "amount": { "type": "number", "title": "Amount" }, "message": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Message" } }, "type": "object", "required": [ "recipient_id", "amount" ], "title": "TipRequest" }, "Token": { "properties": { "access_token": { "type": "string", "title": "Access Token" }, "token_type": { "type": "string", "title": "Token Type" } }, "type": "object", "required": [ "access_token", "token_type" ], "title": "Token" }, "AssetType": { "type": "string", "enum": [ "PINNY", "PINNYPRO", "USD", "EUR" ], "title": "AssetType" }, "TopUpRequest": { "properties": { "amount": { "type": "number", "title": "Amount" }, "provider": { "type": "string", "title": "Provider", "default": "drcp" } }, "type": "object", "required": [ "amount" ], "title": "TopUpRequest" }, "TopUpResponse": { "properties": { "payment_url": { "type": "string", "title": "Payment Url" }, "transaction_id": { "type": "string", "title": "Transaction Id" } }, "type": "object", "required": [ "payment_url", "transaction_id" ], "title": "TopUpResponse" }, "TrainingDocRequest": { "properties": { "type": { "type": "string", "title": "Type" }, "content": { "type": "string", "title": "Content" } }, "type": "object", "required": [ "type", "content" ], "title": "TrainingDocRequest" }, "TransactionType": { "type": "string", "enum": [ "DEPOSIT", "WITHDRAWAL", "TRANSFER", "PURCHASE", "TIP", "REFUND", "ADJUSTMENT", "SUBSCRIPTION", "BOOST", "ANCHORING_FEE", "CONTENT_UNLOCK", "SALE", "TOPUP", "SERVICE_USAGE" ], "title": "TransactionType" }, "TwinAgentStatus": { "properties": { "agent_id": { "type": "string", "title": "Agent Id" }, "name": { "type": "string", "title": "Name" }, "status": { "type": "string", "title": "Status" }, "last_active": { "type": "string", "format": "date-time", "title": "Last Active" } }, "type": "object", "required": [ "agent_id", "name", "status", "last_active" ], "title": "TwinAgentStatus" }, "TwinTrainingDocument": { "properties": { "id": { "type": "string", "title": "Id" }, "type": { "type": "string", "title": "Type" }, "content": { "type": "string", "title": "Content" }, "added_at": { "type": "string", "format": "date-time", "title": "Added At" } }, "type": "object", "required": [ "id", "type", "content", "added_at" ], "title": "TwinTrainingDocument" }, "UnifiedExperienceModules": { "properties": { "real_encounters": { "$ref": "#/components/schemas/ModuleSettings" }, "content_creator": { "$ref": "#/components/schemas/ModuleSettings" }, "marketplace": { "$ref": "#/components/schemas/ModuleSettings" }, "live_stream": { "$ref": "#/components/schemas/ModuleSettings" } }, "type": "object", "title": "UnifiedExperienceModules" }, "UserCreate": { "properties": { "username": { "type": "string", "title": "Username" }, "email": { "type": "string", "format": "email", "title": "Email" }, "password": { "type": "string", "title": "Password" }, "role": { "anyOf": [ { "$ref": "#/components/schemas/UserRole" }, { "type": "null" } ] }, "initial_roles": { "anyOf": [ { "items": { "$ref": "#/components/schemas/UserRole" }, "type": "array" }, { "type": "null" } ], "title": "Initial Roles" }, "wallet_address": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Wallet Address" }, "referral_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Referral Code" } }, "type": "object", "required": [ "username", "email", "password" ], "title": "UserCreate" }, "UserProfile": { "properties": { "id": { "type": "string", "title": "Id" }, "email": { "anyOf": [ { "type": "string", "format": "email" }, { "type": "null" } ], "title": "Email" }, "username": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Username" }, "roles": { "items": { "$ref": "#/components/schemas/UserRole" }, "type": "array", "title": "Roles" }, "price_min": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Price Min", "default": 0.0 }, "pricing": { "additionalProperties": { "type": "number" }, "type": "object", "title": "Pricing" }, "rates": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Rates" }, "payment_methods": { "items": { "type": "string" }, "type": "array", "title": "Payment Methods" }, "location_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Location Name" }, "city": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "City" }, "country": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Country" }, "location": { "anyOf": [ { "$ref": "#/components/schemas/GeoLocation" }, { "type": "null" } ] }, "wallet_address": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Wallet Address" }, "stream_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Stream Key" }, "status": { "$ref": "#/components/schemas/ProfileStatus", "default": "ACTIVE" }, "origin_source": { "$ref": "#/components/schemas/OriginSource", "default": "ORGANIC" }, "profile_type": { "$ref": "#/components/schemas/ProfileType", "default": "user" }, "claim_status": { "$ref": "#/components/schemas/ClaimStatus", "default": "verified" }, "source": { "type": "string", "title": "Source", "default": "user" }, "verification_level": { "$ref": "#/components/schemas/VerificationLevel", "default": 0 }, "verification_status": { "$ref": "#/components/schemas/shared__user_model__VerificationStatus", "default": "NONE" }, "is_verified": { "type": "boolean", "title": "Is Verified", "default": false }, "kyc_status": { "type": "string", "title": "Kyc Status", "default": "none" }, "health_verified": { "type": "boolean", "title": "Health Verified", "default": false }, "health_expiry": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Health Expiry" }, "pro_tier": { "$ref": "#/components/schemas/PinnyProTier", "default": "NONE" }, "pro_expiry": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Pro Expiry" }, "drive": { "$ref": "#/components/schemas/StorageDrive" }, "boost_expiry": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Boost Expiry" }, "copyright_evidence": { "anyOf": [ { "$ref": "#/components/schemas/CopyrightEvidence" }, { "type": "null" } ] }, "boost_level": { "type": "number", "title": "Boost Level", "default": 1.0 }, "is_live": { "type": "boolean", "title": "Is Live", "default": false }, "is_online": { "type": "boolean", "title": "Is Online", "default": false }, "is_available": { "type": "boolean", "title": "Is Available", "default": true }, "last_seen": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Last Seen" }, "availability": { "$ref": "#/components/schemas/Availability" }, "viewer_count": { "type": "integer", "title": "Viewer Count", "default": 0 }, "profile_views": { "type": "integer", "title": "Profile Views", "default": 0 }, "capabilities": { "$ref": "#/components/schemas/Capabilities" }, "experience_modules": { "$ref": "#/components/schemas/UnifiedExperienceModules" }, "offers": { "items": { "$ref": "#/components/schemas/Offer" }, "type": "array", "title": "Offers" }, "resolved_capabilities": { "items": { "type": "string" }, "type": "array", "title": "Resolved Capabilities" }, "wallet_balance": { "type": "number", "title": "Wallet Balance", "default": 0.0 }, "balances": { "additionalProperties": { "type": "number" }, "type": "object", "title": "Balances" }, "level": { "$ref": "#/components/schemas/Level" }, "gamification": { "$ref": "#/components/schemas/Gamification" }, "display_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Display Name" }, "slug": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Slug" }, "bio": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Bio" }, "avatar_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Avatar Url" }, "banner_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Banner Url" }, "gallery": { "items": { "type": "string" }, "type": "array", "title": "Gallery" }, "physical": { "$ref": "#/components/schemas/PhysicalAttributes" }, "identity": { "$ref": "#/components/schemas/IdentityAttributes" }, "social": { "$ref": "#/components/schemas/SocialAttributes" }, "external_sources": { "items": { "$ref": "#/components/schemas/ExternalSource" }, "type": "array", "title": "External Sources" }, "metadata": { "additionalProperties": true, "type": "object", "title": "Metadata" }, "copyright_proofs": { "items": { "$ref": "#/components/schemas/CopyrightEvidence" }, "type": "array", "title": "Copyright Proofs" }, "security": { "$ref": "#/components/schemas/SecuritySettings" }, "assistant_settings": { "$ref": "#/components/schemas/AssistantSettings" }, "active_subscriptions": { "items": { "$ref": "#/components/schemas/UserSubscription" }, "type": "array", "title": "Active Subscriptions" }, "stash_profiles": { "items": { "type": "string" }, "type": "array", "title": "Stash Profiles" }, "stash_products": { "items": { "type": "string" }, "type": "array", "title": "Stash Products" }, "public_wishlist": { "items": { "type": "string" }, "type": "array", "title": "Public Wishlist" }, "purchased_products": { "items": { "type": "string" }, "type": "array", "title": "Purchased Products" }, "has_reels": { "type": "boolean", "title": "Has Reels", "default": false }, "referral_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Referral Code" }, "referred_by_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Referred By Code" }, "referrer_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Referrer Id" }, "referral_count": { "type": "integer", "title": "Referral Count", "default": 0 }, "referral_bonus_claimed": { "type": "boolean", "title": "Referral Bonus Claimed", "default": false }, "rating": { "type": "number", "title": "Rating", "default": 0.0 }, "review_count": { "type": "integer", "title": "Review Count", "default": 0 }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "updated_at": { "type": "string", "format": "date-time", "title": "Updated At" } }, "type": "object", "required": [ "id" ], "title": "UserProfile" }, "UserRole": { "type": "string", "enum": [ "CLIENT", "CREATOR", "ADMIN" ], "title": "UserRole" }, "UserSubscription": { "properties": { "creator_id": { "type": "string", "title": "Creator Id" }, "tier_id": { "type": "string", "title": "Tier Id" }, "expires_at": { "type": "string", "format": "date-time", "title": "Expires At" } }, "type": "object", "required": [ "creator_id", "tier_id", "expires_at" ], "title": "UserSubscription" }, "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" }, "VerificationLevel": { "type": "integer", "enum": [ 0, 1, 2, 3, 4, 1, 2, 3, 0, 1, 2, 2, 3, 3 ], "title": "VerificationLevel" }, "VerificationResponse": { "properties": { "status": { "$ref": "#/components/schemas/hermes__verification_routes__VerificationStatus" }, "confidence_score": { "type": "number", "title": "Confidence Score" }, "message": { "type": "string", "title": "Message" }, "verification_id": { "type": "string", "title": "Verification Id" } }, "type": "object", "required": [ "status", "confidence_score", "message", "verification_id" ], "title": "VerificationResponse" }, "VideoMetadata": { "properties": { "duration_seconds": { "type": "integer", "title": "Duration Seconds", "default": 0 }, "resolution": { "type": "string", "title": "Resolution", "default": "1080p" }, "has_audio": { "type": "boolean", "title": "Has Audio", "default": true }, "thumbnail_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Thumbnail Url" } }, "type": "object", "title": "VideoMetadata" }, "WalletChargeRequest": { "properties": { "user_id": { "type": "string", "title": "User Id" }, "amount": { "type": "number", "title": "Amount" }, "asset_type": { "$ref": "#/components/schemas/AssetType" }, "tx_type": { "$ref": "#/components/schemas/TransactionType" }, "creator_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Creator Id" }, "metadata": { "additionalProperties": true, "type": "object", "title": "Metadata" } }, "type": "object", "required": [ "user_id", "amount", "asset_type", "tx_type" ], "title": "WalletChargeRequest" }, "WalletLoginRequest": { "properties": { "address": { "type": "string", "title": "Address" }, "signature": { "type": "string", "title": "Signature" }, "message": { "type": "string", "title": "Message" } }, "type": "object", "required": [ "address", "signature", "message" ], "title": "WalletLoginRequest" }, "Withdrawal": { "properties": { "id": { "type": "string", "title": "Id" }, "user_id": { "type": "string", "title": "User Id" }, "amount": { "type": "number", "title": "Amount" }, "currency": { "type": "string", "title": "Currency" }, "status": { "$ref": "#/components/schemas/WithdrawalStatus" }, "destination": { "type": "string", "title": "Destination" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "updated_at": { "type": "string", "format": "date-time", "title": "Updated At" } }, "type": "object", "required": [ "id", "user_id", "amount", "currency", "status", "destination", "created_at", "updated_at" ], "title": "Withdrawal" }, "WithdrawalStatus": { "type": "string", "enum": [ "PENDING", "PROCESSING", "COMPLETED", "FAILED", "CANCELLED" ], "title": "WithdrawalStatus" }, "WorkingHours": { "properties": { "day": { "type": "string", "title": "Day" }, "open": { "type": "string", "title": "Open" }, "close": { "type": "string", "title": "Close" }, "is_closed": { "type": "boolean", "title": "Is Closed", "default": false } }, "type": "object", "required": [ "day", "open", "close" ], "title": "WorkingHours" }, "hermes__verification_routes__VerificationStatus": { "type": "string", "enum": [ "PENDING", "APPROVED", "REJECTED", "FAILED" ], "title": "VerificationStatus" }, "shared__user_model__VerificationStatus": { "type": "string", "enum": [ "NONE", "PENDING", "APPROVED", "REJECTED" ], "title": "VerificationStatus" } }, "securitySchemes": { "OAuth2PasswordBearer": { "type": "oauth2", "flows": { "password": { "scopes": {}, "tokenUrl": "/auth/login" } } } } } }