{"openapi":"3.1.0","info":{"title":"Gonka Proxy","description":"OpenAI-compatible AI proxy with token-based billing","version":"2.0.0"},"paths":{"/api/admin/health":{"get":{"tags":["admin"],"summary":"Admin Health","description":"Check if at least one admin user exists in DB. Does not require auth.","operationId":"admin_health_api_admin_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/admin/login":{"post":{"tags":["admin"],"summary":"Admin Login","description":"Login with username/password (stored in DB). Returns token (api_secret) for X-Admin-Secret header.\nCreate first admin with: python -m app.cli create-admin","operationId":"admin_login_api_admin_login_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/users/balances":{"get":{"tags":["admin"],"summary":"Admin Users Balances","description":"List users with prepaid USD balance, all-time usage from proxy logs, and their\nactive subscription with money-allowance usage percentages. The user set is\nsmall (hundreds), so everything is joined and sorted in memory; the one heavy\npiece — the proxy-log rollup — is cached (see _spend_map_from_proxy_logs).","operationId":"admin_users_balances_api_admin_users_balances_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by address, email, or google_id (substring)","title":"Search"},"description":"Filter by address, email, or google_id (substring)"},{"name":"sort","in":"query","required":false,"schema":{"type":"string","description":"created_at, balance (USD), user_id (_id), spent_usd, spent_tokens, last_active, usage (subscription period %), user (label)","default":"created_at","title":"Sort"},"description":"created_at, balance (USD), user_id (_id), spent_usd, spent_tokens, last_active, usage (subscription period %), user (label)"},{"name":"order","in":"query","required":false,"schema":{"type":"string","description":"asc or desc","default":"desc","title":"Order"},"description":"asc or desc"},{"name":"plan","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by subscription: a plan code (free/mini/…/service), 'any' (has an active sub), or 'none' (no active sub)","title":"Plan"},"description":"Filter by subscription: a plan code (free/mini/…/service), 'any' (has an active sub), or 'none' (no active sub)"},{"name":"with_balance","in":"query","required":false,"schema":{"type":"boolean","description":"Only users with balance > 0","default":false,"title":"With Balance"},"description":"Only users with balance > 0"},{"name":"active_days","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Only users with at least one request in the last N days","title":"Active Days"},"description":"Only users with at least one request in the last N days"},{"name":"refresh","in":"query","required":false,"schema":{"type":"boolean","description":"Bypass the cached spend rollup","default":false,"title":"Refresh"},"description":"Bypass the cached spend rollup"},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/users/top-up":{"post":{"tags":["admin"],"summary":"Admin Users Top Up","description":"Add prepaid USD balance to a user (records Transaction type admin_topup).","operationId":"admin_users_top_up_api_admin_users_top_up_post","parameters":[{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopUpRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/logs/policy":{"get":{"tags":["admin"],"summary":"Admin Logs Policy Get","description":"Get global body logging policy defaults.","operationId":"admin_logs_policy_get_api_admin_logs_policy_get","parameters":[{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["admin"],"summary":"Admin Logs Policy Set","description":"Set global defaults for request/response body storage.","operationId":"admin_logs_policy_set_api_admin_logs_policy_put","parameters":[{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BodyLoggingGlobalPolicyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/users/{user_id}/body-policy":{"put":{"tags":["admin"],"summary":"Admin User Body Policy Set","description":"Set per-user override for request/response body storage.","operationId":"admin_user_body_policy_set_api_admin_users__user_id__body_policy_put","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BodyLoggingUserPolicyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["admin"],"summary":"Admin User Body Policy Delete","description":"Delete per-user body policy override (fallback to global policy).","operationId":"admin_user_body_policy_delete_api_admin_users__user_id__body_policy_delete","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/users/{user_id}/body-stats":{"post":{"tags":["admin"],"summary":"Admin User Body Stats","description":"Heavy per-user body stats. Run on demand from admin UI.","operationId":"admin_user_body_stats_api_admin_users__user_id__body_stats_post","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/users/{user_id}/body-data":{"delete":{"tags":["admin"],"summary":"Admin User Clear Body Data","description":"Remove stored request/response bodies for specific user logs (metadata stays).","operationId":"admin_user_clear_body_data_api_admin_users__user_id__body_data_delete","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/stats/database":{"get":{"tags":["admin"],"summary":"Stats Database","description":"Same payload as `db_stats` inside GET /stats/overview?include_db=1 (for scripts / debugging).","operationId":"stats_database_api_admin_stats_database_get","parameters":[{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/stats/overview":{"get":{"tags":["admin"],"summary":"Stats Overview","description":"Totals and percentages: requests, success/error counts, error rate %, GNK spent, tokens.","operationId":"stats_overview_api_admin_stats_overview_get","parameters":[{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"From"}},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"To"}},{"name":"include_db","in":"query","required":false,"schema":{"type":"boolean","description":"If true, include db_stats (MongoDB sizes + proxy_logs aggregates). Used by admin Database page so one request reuses the same route as the dashboard.","default":false,"title":"Include Db"},"description":"If true, include db_stats (MongoDB sizes + proxy_logs aggregates). Used by admin Database page so one request reuses the same route as the dashboard."},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/stats/by-users":{"get":{"tags":["admin"],"summary":"Stats By Users","description":"Aggregation by user_address: request count, errors, USD spent, tokens.","operationId":"stats_by_users_api_admin_stats_by_users_get","parameters":[{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"From"}},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"To"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/stats/active-users":{"get":{"tags":["admin"],"summary":"Stats Active Users","description":"Period engagement for the dashboard:\n- signups: new users (users.created_at in range)\n- logins: distinct users who authenticated (login_events; forward-looking)\n- active_api_users: distinct users with >=1 proxy request in range\n- top_users: most active by API request count, enriched with balance,\n  subscription (plan + remaining quota + period end) and favourite model.","operationId":"stats_active_users_api_admin_stats_active_users_get","parameters":[{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"From"}},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"To"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":10,"title":"Limit"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/stats/by-api-keys":{"get":{"tags":["admin"],"summary":"Stats By Api Keys","description":"Aggregation by api_key_id: request count, errors, USD spent, tokens.","operationId":"stats_by_api_keys_api_admin_stats_by_api_keys_get","parameters":[{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"From"}},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"To"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/stats/by-day":{"get":{"tags":["admin"],"summary":"Stats By Day","description":"Aggregated metrics per calendar day (UTC): requests, success/errors, GNK, tokens. Newest days first.","operationId":"stats_by_day_api_admin_stats_by_day_get","parameters":[{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"From"}},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"To"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":366,"minimum":1,"default":60,"title":"Limit"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/stats/by-hour":{"get":{"tags":["admin"],"summary":"Stats By Hour","description":"Aggregated metrics per clock hour (UTC): requests, success/errors, GNK, tokens. Hours ascending (oldest first).","operationId":"stats_by_hour_api_admin_stats_by_hour_get","parameters":[{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"From"}},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"To"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":168,"minimum":1,"default":168,"title":"Limit"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/stats/errors":{"get":{"tags":["admin"],"summary":"Stats Errors","description":"Counts by error_category and optionally by response_status.","operationId":"stats_errors_api_admin_stats_errors_get","parameters":[{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"From"}},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"To"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/stats/slo":{"get":{"tags":["admin"],"summary":"Stats Slo","description":"SLO summary over /v1/* traffic: error split (ours / upstream / technical),\nlatency percentiles and streaming TTFB percentiles, hourly series included.\nDefaults to the last 24h when no range is given.","operationId":"stats_slo_api_admin_stats_slo_get","parameters":[{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"From"}},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"To"}},{"name":"exclude_self","in":"query","required":false,"schema":{"type":"integer","description":"1 = drop admin users' own traffic from all numbers","default":1,"title":"Exclude Self"},"description":"1 = drop admin users' own traffic from all numbers"},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/routing/upstream-timeline":{"get":{"tags":["admin"],"summary":"Admin Upstream Timeline","description":"Availability history per upstream (and per model on it), bucketed.\n\nSourced from upstream_health_samples — one snapshot per node per probe tick\n(~1/min). Each cell is the fraction of samples in that bucket where the\nupstream (or that model on it) was available.","operationId":"admin_upstream_timeline_api_admin_routing_upstream_timeline_get","parameters":[{"name":"hours","in":"query","required":false,"schema":{"type":"integer","maximum":168,"minimum":1,"default":48,"title":"Hours"}},{"name":"bucket_minutes","in":"query","required":false,"schema":{"type":"integer","description":"1, 2, 5, 10, 15, 30 or 60","default":10,"title":"Bucket Minutes"},"description":"1, 2, 5, 10, 15, 30 or 60"},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/routing-status":{"get":{"tags":["admin"],"summary":"Admin Routing Status","description":"Live routing mode, Gonka pool / cooldowns (memory + Mongo for multi-worker), ML health.","operationId":"admin_routing_status_api_admin_routing_status_get","parameters":[{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/routing/test-upstream":{"post":{"tags":["admin"],"summary":"Admin Test Upstream","description":"Send ONE minimal chat completion to a specific upstream (devshard) to verify it\nworks right now: reachability + auth + inference + latency. Bypasses pool routing.\n\nWARNING: this is a real inference call — on a paid upstream (openbroker) it costs a\ntiny amount. It's an explicit admin action, triggered per-click.","operationId":"admin_test_upstream_api_admin_routing_test_upstream_post","parameters":[{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestUpstreamBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/stats/by-backend-node":{"get":{"tags":["admin"],"summary":"Stats By Backend Node","description":"Per-node request/error counts and error mix (proxy logs), respecting time filters.","operationId":"stats_by_backend_node_api_admin_stats_by_backend_node_get","parameters":[{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"From"}},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"To"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":40,"title":"Limit"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/logs":{"get":{"tags":["admin"],"summary":"Admin Logs","description":"Paginated list of proxy log entries (metadata only; no full body).","operationId":"admin_logs_api_admin_logs_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"user_address","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Address"}},{"name":"api_key_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Api Key Id"}},{"name":"error_category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Category"}},{"name":"request_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by X-Request-Id stored in logs","title":"Request Id"},"description":"Filter by X-Request-Id stored in logs"},{"name":"devshard_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by X-Devshard-ID stored in logs","title":"Devshard Id"},"description":"Filter by X-Devshard-ID stored in logs"},{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"From"}},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"To"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/lookup/by-request-id/{request_id}":{"get":{"tags":["admin"],"summary":"Admin Lookup By Request Id","description":"Find the user (and the matching log entry) for a given X-Request-Id.","operationId":"admin_lookup_by_request_id_api_admin_lookup_by_request_id__request_id__get","parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","title":"Request Id"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/lookup/by-devshard-id/{devshard_id}":{"get":{"tags":["admin"],"summary":"Admin Lookup By Devshard Id","description":"Find a recent log entry (and its user) for a given X-Devshard-ID.","operationId":"admin_lookup_by_devshard_id_api_admin_lookup_by_devshard_id__devshard_id__get","parameters":[{"name":"devshard_id","in":"path","required":true,"schema":{"type":"string","title":"Devshard Id"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/logs/{log_id}":{"get":{"tags":["admin"],"summary":"Admin Log By Id","description":"Get a single proxy log entry by id (for detail view). Includes request_body and response_body when stored.","operationId":"admin_log_by_id_api_admin_logs__log_id__get","parameters":[{"name":"log_id","in":"path","required":true,"schema":{"type":"string","title":"Log Id"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/waitlist/priority":{"get":{"tags":["admin"],"summary":"Admin Waitlist Priority","description":"List Priority-tier waitlist entries (newest first).","operationId":"admin_waitlist_priority_api_admin_waitlist_priority_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/billing/subscriptions":{"get":{"tags":["admin"],"summary":"Admin Subscriptions","description":"List subscriptions (newest first), optionally filtered by status/brand.","operationId":"admin_subscriptions_api_admin_billing_subscriptions_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"active|canceled|past_due|trialing","title":"Status"},"description":"active|canceled|past_due|trialing"},{"name":"brand","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"mingo|gonka — filtered via joined user.brand","title":"Brand"},"description":"mingo|gonka — filtered via joined user.brand"},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/billing/subscriptions/{sub_id}/cancel":{"post":{"tags":["admin"],"summary":"Admin Cancel Subscription","description":"Force-mark a subscription canceled locally. Stripe-side cancel must be done via Stripe dashboard.","operationId":"admin_cancel_subscription_api_admin_billing_subscriptions__sub_id__cancel_post","parameters":[{"name":"sub_id","in":"path","required":true,"schema":{"type":"string","title":"Sub Id"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/billing/pricing":{"get":{"tags":["admin"],"summary":"Admin Pricing","description":"Current per-model pricing (admin view, USD per 1M tokens).","operationId":"admin_pricing_api_admin_billing_pricing_get","parameters":[{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/billing/pricing/{model}":{"put":{"tags":["admin"],"summary":"Admin Set Pricing","description":"Set per-million USD price for a single model.","operationId":"admin_set_pricing_api_admin_billing_pricing__model__put","parameters":[{"name":"model","in":"path","required":true,"schema":{"type":"string","title":"Model"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_admin_set_pricing_api_admin_billing_pricing__model__put"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/billing/signup-channels":{"get":{"tags":["admin"],"summary":"Admin List Signup Channels","description":"All signup channels (used to attribute new users and credit USD bonuses).","operationId":"admin_list_signup_channels_api_admin_billing_signup_channels_get","parameters":[{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/billing/signup-channels/{code}":{"put":{"tags":["admin"],"summary":"Admin Upsert Signup Channel","description":"Create or update a signup channel. `code` is the URL utm_source slug (lowercased).","operationId":"admin_upsert_signup_channel_api_admin_billing_signup_channels__code__put","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","title":"Code"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_admin_upsert_signup_channel_api_admin_billing_signup_channels__code__put"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["admin"],"summary":"Admin Delete Signup Channel","description":"Soft-disable a channel (no destructive delete — we keep historical stats).","operationId":"admin_delete_signup_channel_api_admin_billing_signup_channels__code__delete","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","title":"Code"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/billing/referrals":{"get":{"tags":["admin"],"summary":"Admin Referrals","description":"Referral program overview: reward config, payout totals from transactions,\nper-frontend breakdown, inviter leaderboard, and recent activity log.","operationId":"admin_referrals_api_admin_billing_referrals_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"events_limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Events Limit"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/billing/referrals/partner/{ident}":{"get":{"tags":["admin"],"summary":"Admin Referral Partner","description":"One partner's effective terms, commission balances, earnings ledger and\nwithdrawal history.","operationId":"admin_referral_partner_api_admin_billing_referrals_partner__ident__get","parameters":[{"name":"ident","in":"path","required":true,"schema":{"type":"string","title":"Ident"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["admin"],"summary":"Admin Referral Partner Terms","description":"Create/update per-partner term overrides for ANY user (even one with no\nreferrals yet). Send null for a field to clear its override (falls back to the\nglobal default). `invited_bonus_usd` sets what THIS inviter's invitees get.","operationId":"admin_referral_partner_terms_api_admin_billing_referrals_partner__ident__put","parameters":[{"name":"ident","in":"path","required":true,"schema":{"type":"string","title":"Ident"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_admin_referral_partner_terms_api_admin_billing_referrals_partner__ident__put"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/promo-codes":{"post":{"tags":["admin"],"summary":"Admin Create Promo Code","description":"Create a promo code. kind ∈ balance|discount|free_sub. Inactive codes\ngrant nothing until is_active=true.","operationId":"admin_create_promo_code_api_admin_promo_codes_post","parameters":[{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_admin_create_promo_code_api_admin_promo_codes_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["admin"],"summary":"Admin List Promo Codes","operationId":"admin_list_promo_codes_api_admin_promo_codes_get","parameters":[{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/promo-codes/{code}":{"patch":{"tags":["admin"],"summary":"Admin Update Promo Code","description":"Update an existing code's window / caps / active flag / note.","operationId":"admin_update_promo_code_api_admin_promo_codes__code__patch","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","title":"Code"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_admin_update_promo_code_api_admin_promo_codes__code__patch"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/promo-codes/{code}/redemptions":{"get":{"tags":["admin"],"summary":"Admin Promo Redemptions","operationId":"admin_promo_redemptions_api_admin_promo_codes__code__redemptions_get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","title":"Code"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/billing/referrals/partner/{ident}/withdraw":{"post":{"tags":["admin"],"summary":"Admin Referral Withdraw","description":"Record a manual commission payout to a partner. Validates the amount does\nnot exceed the available (matured, un-withdrawn) balance.","operationId":"admin_referral_withdraw_api_admin_billing_referrals_partner__ident__withdraw_post","parameters":[{"name":"ident","in":"path","required":true,"schema":{"type":"string","title":"Ident"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_admin_referral_withdraw_api_admin_billing_referrals_partner__ident__withdraw_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/users/{user_ident}/subscriptions":{"get":{"tags":["admin"],"summary":"Admin User Subscriptions","description":"All subscriptions for one user (active, expired, canceled).","operationId":"admin_user_subscriptions_api_admin_users__user_ident__subscriptions_get","parameters":[{"name":"user_ident","in":"path","required":true,"schema":{"type":"string","title":"User Ident"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/users/{user_ident}/credit":{"post":{"tags":["admin"],"summary":"Admin User Credit","description":"Credit (or debit, if amount<0) a user's prepaid USD balance with a recorded\nTransaction. Use sparingly — every change is logged with type 'admin_adjust'.","operationId":"admin_user_credit_api_admin_users__user_ident__credit_post","parameters":[{"name":"user_ident","in":"path","required":true,"schema":{"type":"string","title":"User Ident"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_admin_user_credit_api_admin_users__user_ident__credit_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/users/{user_ident}/grant-plan":{"post":{"tags":["admin"],"summary":"Admin User Grant Plan","description":"Manually activate a complimentary subscription on a user (provider='gift').\nUse for VIP onboarding, support refunds, contests.\n\n`period_days` null or 0 grants a subscription that never expires — that is how\nthe internal `service` plan is handed to a test account (it is perpetual by\ndefinition, whatever is passed here).","operationId":"admin_user_grant_plan_api_admin_users__user_ident__grant_plan_post","parameters":[{"name":"user_ident","in":"path","required":true,"schema":{"type":"string","title":"User Ident"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_admin_user_grant_plan_api_admin_users__user_ident__grant_plan_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/users/{user_ident}/cancel-sub":{"post":{"tags":["admin"],"summary":"Admin User Cancel Sub","description":"Cancel a user's subscription. By default cancels at period end so the\nuser keeps benefits they paid for. Set cancel_at_period_end=false to\nterminate immediately (use sparingly — no refund is issued).","operationId":"admin_user_cancel_sub_api_admin_users__user_ident__cancel_sub_post","parameters":[{"name":"user_ident","in":"path","required":true,"schema":{"type":"string","title":"User Ident"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_admin_user_cancel_sub_api_admin_users__user_ident__cancel_sub_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/billing/grant-bulk":{"post":{"tags":["admin"],"summary":"Admin Grant Bulk","description":"One-shot bulk grant across all users matching the brand. Idempotent via\nmarker: re-running with the same marker is a no-op for already-granted users.","operationId":"admin_grant_bulk_api_admin_billing_grant_bulk_post","parameters":[{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_admin_grant_bulk_api_admin_billing_grant_bulk_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/billing/revenue":{"get":{"tags":["admin"],"summary":"Admin Revenue","description":"Revenue snapshot for the last N days: deposits split by currency + active sub count.\n\nReads from Transaction (type=deposit) — captures both Stripe top-ups\n(USD) and NOWPayments (USD or GNK).","operationId":"admin_revenue_api_admin_billing_revenue_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"default":30,"title":"Days"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/billing/funnel":{"get":{"tags":["admin"],"summary":"Admin Payment Funnel","description":"Payment funnel split by brand (mingo/gonka) × provider (stripe / nowpayments\n/ balance / gnk_chain) × kind (topup/subscription).\n\nReturns attempt → success / failure counts, conversion %, revenue, the top\nfailure reasons, and the most recent raw events. Default window (when no\nfrom/to is supplied) is the last 7 days — keeps the admin page fast.","operationId":"admin_payment_funnel_api_admin_billing_funnel_get","parameters":[{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"From"}},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"To"}},{"name":"recent_limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":0,"default":100,"title":"Recent Limit"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/emails/overview":{"get":{"tags":["admin"],"summary":"Admin Emails Overview","description":"Counts for the Emails dashboard header.\n\nReturns recent-window aggregates for both transactional sends (email_log)\nand the drip queue (email_jobs).","operationId":"admin_emails_overview_api_admin_emails_overview_get","parameters":[{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/emails/log":{"get":{"tags":["admin"],"summary":"Admin Emails Log","description":"Recent transactional sends from email_log (newest first).","operationId":"admin_emails_log_api_admin_emails_log_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by recipient email","title":"To"},"description":"Filter by recipient email"},{"name":"key_prefix","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter message_key prefix (e.g. 'welcome:')","title":"Key Prefix"},"description":"Filter message_key prefix (e.g. 'welcome:')"},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/emails/jobs":{"get":{"tags":["admin"],"summary":"Admin Emails Jobs","description":"Drip queue inspection — pending/sent/cancelled jobs by filter.","operationId":"admin_emails_jobs_api_admin_emails_jobs_get","parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"pending | sent | cancelled | failed | skipped | in_progress","title":"Status"},"description":"pending | sent | cancelled | failed | skipped | in_progress"},{"name":"template","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Template"}},{"name":"user_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/emails/templates":{"get":{"tags":["admin"],"summary":"Admin Emails Templates","description":"List registered drip templates the worker knows how to dispatch.","operationId":"admin_emails_templates_api_admin_emails_templates_get","parameters":[{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/emails/jobs/{job_id}/cancel":{"post":{"tags":["admin"],"summary":"Admin Emails Cancel Job","description":"Manually cancel a pending job (e.g. testing a misfire).","operationId":"admin_emails_cancel_job_api_admin_emails_jobs__job_id__cancel_post","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/emails/suppression":{"get":{"tags":["admin"],"summary":"Admin Emails Suppression","description":"Unsubscribed / bounced addresses, newest first.","operationId":"admin_emails_suppression_api_admin_emails_suppression_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":200,"title":"Limit"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/emails/suppression/{email}":{"delete":{"tags":["admin"],"summary":"Admin Emails Unsuppress","description":"Remove an address from the suppression list (rare — useful for false-positive bounces).\n\nGoes through the bounce module so the rest of the verdict is undone too:\nthe undeliverable flag on the account and the suspended free plan.","operationId":"admin_emails_unsuppress_api_admin_emails_suppression__email__delete","parameters":[{"name":"email","in":"path","required":true,"schema":{"type":"string","title":"Email"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/emails/deliveries":{"get":{"tags":["admin"],"summary":"Admin Emails Deliveries","description":"Per-attempt send log — the answer to 'did that verification mail leave?'.","operationId":"admin_emails_deliveries_api_admin_emails_deliveries_get","parameters":[{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by recipient","title":"To"},"description":"Filter by recipient"},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"sent | failed | suppressed | not_configured","title":"Status"},"description":"sent | failed | suppressed | not_configured"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":200,"title":"Limit"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/emails/bounces":{"get":{"tags":["admin"],"summary":"Admin Emails Bounces","description":"Per-address bounce state: soft-bounce streaks and hard-bounce stamps.","operationId":"admin_emails_bounces_api_admin_emails_bounces_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":200,"title":"Limit"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/emails/bounces/poll":{"post":{"tags":["admin"],"summary":"Admin Emails Bounces Poll","description":"Run one IMAP sweep now instead of waiting for the poll interval.","operationId":"admin_emails_bounces_poll_api_admin_emails_bounces_poll_post","parameters":[{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/emails/bounces/import":{"post":{"tags":["admin"],"summary":"Admin Emails Bounces Import","description":"Import a bounce report by hand — the route when IMAP is off.\n\nBody: {raw, emails[], severity, apply, force}. `raw` takes a downloaded\n.eml, several concatenated, a copy-paste of the provider's text, or just a\nlist of addresses. Defaults to a dry run: nothing changes until the caller\nposts again with apply=true.","operationId":"admin_emails_bounces_import_api_admin_emails_bounces_import_post","parameters":[{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/emails/test":{"post":{"tags":["admin"],"summary":"Admin Emails Test","description":"Send a one-off test email to verify SMTP + DNS work end-to-end.\n\n`template` selects a render function. Supports the transactional shapes\nthat don't need DB context (welcome, balance_low, payment_failed, topup,\nsub_activated, sub_cancelled). Anything else falls back to a plain text\n\"Hello from <brand>\".","operationId":"admin_emails_test_api_admin_emails_test_post","parameters":[{"name":"to","in":"query","required":true,"schema":{"type":"string","title":"To"}},{"name":"template","in":"query","required":false,"schema":{"type":"string","default":"welcome","title":"Template"}},{"name":"brand","in":"query","required":false,"schema":{"type":"string","default":"mingo","title":"Brand"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/chat/sessions":{"get":{"tags":["admin"],"summary":"Admin List Chat Sessions","operationId":"admin_list_chat_sessions_api_admin_chat_sessions_get","parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/chat/sessions/{session_id}":{"get":{"tags":["admin"],"summary":"Admin Get Chat Session","operationId":"admin_get_chat_session_api_admin_chat_sessions__session_id__get","parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/chat/sessions/{session_id}/reply":{"post":{"tags":["admin"],"summary":"Admin Reply Chat Session","operationId":"admin_reply_chat_session_api_admin_chat_sessions__session_id__reply_post","parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatReplyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/chat/sessions/{session_id}/takeover":{"post":{"tags":["admin"],"summary":"Admin Takeover Chat Session","operationId":"admin_takeover_chat_session_api_admin_chat_sessions__session_id__takeover_post","parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/chat/sessions/{session_id}/release":{"post":{"tags":["admin"],"summary":"Admin Release Chat Session","operationId":"admin_release_chat_session_api_admin_chat_sessions__session_id__release_post","parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/chat/sessions/{session_id}/resolve":{"post":{"tags":["admin"],"summary":"Admin Resolve Chat Session","operationId":"admin_resolve_chat_session_api_admin_chat_sessions__session_id__resolve_post","parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/chat/sessions/{session_id}/summarize":{"post":{"tags":["admin"],"summary":"Admin Summarize Chat Session","operationId":"admin_summarize_chat_session_api_admin_chat_sessions__session_id__summarize_post","parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/blocked-domains":{"get":{"tags":["admin"],"summary":"Admin Blocked Domains","operationId":"admin_blocked_domains_api_admin_blocked_domains_get","parameters":[{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["admin"],"summary":"Admin Block Domain","operationId":"admin_block_domain_api_admin_blocked_domains_post","parameters":[{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/blocked-domains/{domain}":{"delete":{"tags":["admin"],"summary":"Admin Unblock Domain","operationId":"admin_unblock_domain_api_admin_blocked_domains__domain__delete","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","title":"Domain"}},{"name":"X-Admin-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/billing/me":{"get":{"tags":["billing"],"summary":"Billing Me","description":"Current user's balances, subscriptions, referral, brand.","operationId":"billing_me_billing_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Billing Me Billing Me Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/billing/models/rates":{"get":{"tags":["billing"],"summary":"Model Rates","description":"Public per-model rate card — what the console and docs render.","operationId":"model_rates_billing_models_rates_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Model Rates Billing Models Rates Get"}}}}}}},"/billing/usage":{"get":{"tags":["billing"],"summary":"Billing Usage","description":"Plan consumption as percentages — the only usage shape we expose publicly.\n\nThree bars (5-hour window, week, billing period) plus a per-model burn rate, and\ndeliberately no absolute numbers. Token counts and dollar amounts stay server-side\nso the limits can be retuned without contradicting something a user was shown; a\npercentage of \"your plan\" survives a retune, \"6M tokens\" does not.\n\nThe burn rate is each model's price relative to the cheapest one we serve, which\nis what the model picker shows next to the name (\"×2 — spends your plan twice as\nfast\"). It falls out of the price table, so a repricing updates it for free.","operationId":"billing_usage_billing_usage_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Billing Usage Billing Usage Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/billing/promo/claim":{"post":{"tags":["billing"],"summary":"Promo Claim","description":"Apply signup channel + referral bonuses. Idempotent: 200 with reason on retry.","operationId":"promo_claim_billing_promo_claim_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PromoClaimRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Promo Claim Billing Promo Claim Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/billing/pricing":{"get":{"tags":["billing"],"summary":"List Plans","description":"Public plan list (single USD product — all active plans).\n\nAgency tiers (plan_group == \"agency\") are excluded by default so they stay\nout of the self-serve /app picker; pass ?group=agency to fetch only those.\nThey remain chargeable by code via /billing/checkout/subscribe regardless.\n\nInternal plans (plan_group == \"internal\" — the service tier handed to test\naccounts) are never listed, whatever group the caller asks for, and every\ncheckout endpoint refuses them.","operationId":"list_plans_billing_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response List Plans Billing Pricing Get"}}}}}}},"/billing/checkout/topup":{"post":{"tags":["billing"],"summary":"Checkout Topup","operationId":"checkout_topup_billing_checkout_topup_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopupRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Checkout Topup Billing Checkout Topup Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/billing/checkout/subscribe":{"post":{"tags":["billing"],"summary":"Checkout Subscribe","operationId":"checkout_subscribe_billing_checkout_subscribe_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscribeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Checkout Subscribe Billing Checkout Subscribe Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/billing/checkout/crypto-topup":{"post":{"tags":["billing"],"summary":"Checkout Crypto Topup","description":"One-time crypto top-up via NOWPayments (stable-coins). Credits the\nprepaid USD inference balance at the confirmed amount.","operationId":"checkout_crypto_topup_billing_checkout_crypto_topup_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CryptoTopupRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Checkout Crypto Topup Billing Checkout Crypto Topup Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/billing/checkout/subscribe-from-balance":{"post":{"tags":["billing"],"summary":"Checkout Subscribe From Balance","description":"Activate a paid plan by debiting the user's prepaid USD balance.\n\nOn insufficient funds, responds 402 with a body the UI can use to deep-link\ninto the top-up flow (top-up minimum = the shortfall, rounded up to the\nnearest $1).","operationId":"checkout_subscribe_from_balance_billing_checkout_subscribe_from_balance_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscribeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Checkout Subscribe From Balance Billing Checkout Subscribe From Balance Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/billing/checkout/subscribe-crypto":{"post":{"tags":["billing"],"summary":"Checkout Subscribe Crypto","description":"Pay a subscription with crypto (NOWPayments invoice). Activates a 30-day\nplan period on confirmed IPN. No auto-renewal — user pays again to extend.","operationId":"checkout_subscribe_crypto_billing_checkout_subscribe_crypto_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CryptoSubscribeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Checkout Subscribe Crypto Billing Checkout Subscribe Crypto Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/billing/crypto/currencies":{"get":{"tags":["billing"],"summary":"Crypto Currencies","description":"Pay currencies allowed for crypto top-up (stable-coins).","operationId":"crypto_currencies_billing_crypto_currencies_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Crypto Currencies Billing Crypto Currencies Get"}}}}}}},"/billing/platega/quote":{"get":{"tags":["billing"],"summary":"Platega Quote","description":"USD→RUB estimate (CBR rate + markup) so the wizard can show `≈ ₽…`.\nThe authoritative ruble amount is fixed at checkout-creation time.","operationId":"platega_quote_billing_platega_quote_get","parameters":[{"name":"usd","in":"query","required":true,"schema":{"type":"number","title":"Usd"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Platega Quote Billing Platega Quote Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/billing/checkout/platega-topup":{"post":{"tags":["billing"],"summary":"Checkout Platega Topup","description":"One-time RUB top-up via Platega (СБП / crypto). Credits the prepaid USD\nbalance with the full requested amount on confirmation.","operationId":"checkout_platega_topup_billing_checkout_platega_topup_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlategaTopupRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Checkout Platega Topup Billing Checkout Platega Topup Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/billing/checkout/platega-subscribe":{"post":{"tags":["billing"],"summary":"Checkout Platega Subscribe","description":"Pay a subscription in RUB via Platega. Activates a 30-day period on\nconfirmation. No auto-renewal — the user pays again to extend.","operationId":"checkout_platega_subscribe_billing_checkout_platega_subscribe_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlategaSubscribeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Checkout Platega Subscribe Billing Checkout Platega Subscribe Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/billing/subscription/cancel-renewal":{"post":{"tags":["billing"],"summary":"Cancel Subscription Renewal","description":"Turn off auto-renewal on the active paid subscription. The user keeps\nplan benefits until period_end, then drops to Free automatically.","operationId":"cancel_subscription_renewal_billing_subscription_cancel_renewal_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Cancel Subscription Renewal Billing Subscription Cancel Renewal Post"}}}}},"security":[{"HTTPBearer":[]}]}},"/billing/subscription/resume":{"post":{"tags":["billing"],"summary":"Resume Subscription","description":"Reverse a pending cancel-at-period-end so the paid plan renews again.","operationId":"resume_subscription_billing_subscription_resume_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Resume Subscription Billing Subscription Resume Post"}}}}},"security":[{"HTTPBearer":[]}]}},"/billing/stripe/webhook":{"post":{"tags":["billing"],"summary":"Stripe Webhook","description":"Stripe-signed webhook; verifies HMAC then dispatches via process_event.","operationId":"stripe_webhook_billing_stripe_webhook_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/billing/nowpayments/webhook":{"post":{"tags":["billing"],"summary":"Nowpayments Webhook","description":"NOWPayments IPN. Header: x-nowpayments-sig (HMAC-SHA512 over sorted JSON).","operationId":"nowpayments_webhook_billing_nowpayments_webhook_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/billing/platega/webhook":{"post":{"tags":["billing"],"summary":"Platega Webhook","description":"Platega status-change callback. Authenticated by the X-MerchantId /\nX-Secret headers (no HMAC in Platega's spec); we constant-time compare them\nand re-confirm the status via the API before crediting. Reply 200 within 60s\nor Platega retries up to 3× at 5-min intervals.","operationId":"platega_webhook_billing_platega_webhook_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/chat/session":{"post":{"tags":["chat"],"summary":"Create Session","operationId":"create_session_api_chat_session_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/chat/whoami":{"get":{"tags":["chat"],"summary":"Whoami","description":"Tell the widget who the server thinks it is (from cookie/bearer), so it can\nshow a logged-in state without trusting client-injected identity.","operationId":"whoami_api_chat_whoami_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/chat/message":{"post":{"tags":["chat"],"summary":"Post Message","operationId":"post_message_api_chat_message_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/chat/history/{session_id}":{"get":{"tags":["chat"],"summary":"History","operationId":"history_api_chat_history__session_id__get","parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/chat/handoff":{"post":{"tags":["chat"],"summary":"Handoff","operationId":"handoff_api_chat_handoff_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HandoffRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/chat/contact":{"post":{"tags":["chat"],"summary":"Contact","description":"Capture the email an anonymous visitor leaves so we can email them when a\nhuman replies. Also links the session to an existing account if the email\nmatches one.","operationId":"contact_api_chat_contact_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/chat/feedback":{"post":{"tags":["chat"],"summary":"Feedback","operationId":"feedback_api_chat_feedback_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedbackRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/chat/escalation":{"post":{"tags":["chat"],"summary":"Submit Escalation","operationId":"submit_escalation_api_chat_escalation_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EscalationRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/telegram/webhook/{secret}":{"post":{"tags":["telegram"],"summary":"Telegram Webhook","operationId":"telegram_webhook_api_telegram_webhook__secret__post","parameters":[{"name":"secret","in":"path","required":true,"schema":{"type":"string","title":"Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/responses":{"post":{"tags":["responses"],"summary":"Create Response","description":"OpenAI Responses API over our chat-completions pipeline.\n\nBilling, routing and logging all happen inside the downstream handler, which is\nthe same code path a direct /v1/chat/completions call takes.","operationId":"create_response_v1_responses_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/email/unsubscribe":{"get":{"summary":"Email Unsubscribe","description":"One-click unsubscribe for transactional/marketing emails.\n\nLinked from the List-Unsubscribe header and footer of every email. Idempotent.\nService-critical emails (billing receipts, security alerts) still send —\nsuppression only blocks non-essential lifecycle messages.","operationId":"email_unsubscribe_api_email_unsubscribe_get","parameters":[{"name":"email","in":"query","required":false,"schema":{"type":"string","default":"","title":"Email"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/donation/addresses":{"get":{"summary":"Donation Addresses","description":"Public addresses for one-off GNK/EVM donations.","operationId":"donation_addresses_api_donation_addresses_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/waitlist/priority":{"post":{"summary":"Waitlist Priority","description":"Submit a Priority-tier waitlist entry. Public endpoint, no auth required.","operationId":"waitlist_priority_api_waitlist_priority_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PriorityWaitlistRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agency-inquiry":{"post":{"summary":"Agency Inquiry","description":"B2B agency lead from the /agencies landing. Public — no auth required.\n\nRecords a needs-reply incident and notifies the team by email + Telegram,\nmirroring /api/sales-inquiry but for anonymous (not-yet-signed-up) visitors.","operationId":"agency_inquiry_api_agency_inquiry_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgencyInquiryRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/auth/google/start":{"get":{"summary":"Google Auth Start","description":"Start Google OAuth flow - redirect to Google","operationId":"google_auth_start_api_auth_google_start_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/auth/google/callback":{"get":{"summary":"Google Auth Callback","description":"Handle Google OAuth callback","operationId":"google_auth_callback_api_auth_google_callback_get","parameters":[{"name":"code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/auth/signup-config":{"get":{"summary":"Auth Signup Config","description":"Pre-auth config the signup form needs (currently: the Turnstile site key).","operationId":"auth_signup_config_api_auth_signup_config_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/auth/register":{"post":{"summary":"Auth Register","description":"Register with email + password. Creates an unverified account and emails a\nverification link. The welcome bonus is granted only after verification, so\nthrowaway emails can't farm it.","operationId":"auth_register_api_auth_register_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailRegisterRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/auth/verify":{"get":{"summary":"Auth Verify","description":"Consume an email-verification token, activate the account, sign the user in.","operationId":"auth_verify_api_auth_verify_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/auth/login":{"post":{"summary":"Auth Login","description":"Email + password login. Returns the web-interface API key used as the session token.","operationId":"auth_login_api_auth_login_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailLoginRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/auth/forgot-password":{"post":{"summary":"Auth Forgot Password","description":"Send a password-reset link. Always returns ok to avoid email enumeration.","operationId":"auth_forgot_password_api_auth_forgot_password_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForgotPasswordRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/auth/reset-password":{"post":{"summary":"Auth Reset Password","description":"Consume a reset token and set a new password.","operationId":"auth_reset_password_api_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"}}}}}}},"/api/user/me":{"get":{"summary":"Get Current User","description":"Get current user info","operationId":"get_current_user_api_user_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/billing/promo/preview":{"post":{"summary":"Preview Promo Code","description":"Validate a promo code WITHOUT redeeming it (so the checkout UI can show the\ndiscount and the user can re-check the same code freely).","operationId":"preview_promo_code_billing_promo_preview_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/sales-inquiry":{"post":{"summary":"Sales Inquiry","description":"Team / startup request for custom terms. Records an incident and notifies\nthe team by email + Telegram; the frontend also forwards it to the support\nchat agent. Always tied to the signed-in account (email + profile data).","operationId":"sales_inquiry_api_sales_inquiry_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/billing/promo/redeem":{"post":{"summary":"Redeem Promo Code","description":"Redeem a promo code for the authenticated user (balance / discount / free_sub).","operationId":"redeem_promo_code_billing_promo_redeem_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/user/balance":{"get":{"summary":"Get Balance","description":"Get user balance (prepaid USD inference balance). Includes low_balance for\nagent automation (e.g. when to request payment). `balance` is a float USD\namount, kept under this key for OpenClaw bot back-compat.","operationId":"get_balance_api_user_balance_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/register-bot":{"post":{"summary":"Register Bot Step1","description":"Step 1: Submit deviceId and publicKeyPem; receive a challenge to sign.\nRate limit: 30 requests per hour per IP.\nFor re-registration (device already in DB) we use stored publicKeyPem and do not validate the body again.","operationId":"register_bot_step1_api_register_bot_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterBotRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/register-bot/verify":{"post":{"summary":"Register Bot Step2","description":"Step 2: Submit deviceId, challenge, and signature. Receive API key and balance.\nFirst-time: new user + bonus balance. Re-registration: new key only, no bonus.","operationId":"register_bot_step2_api_register_bot_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterBotVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/keys":{"get":{"summary":"List Api Keys","description":"List user's API keys","operationId":"list_api_keys_api_keys_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]},"post":{"summary":"Create Api Key","description":"Create new API key","operationId":"create_api_key_api_keys_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAPIKeyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/keys/{key_id}":{"delete":{"summary":"Delete Api Key","description":"Delete API key","operationId":"delete_api_key_api_keys__key_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/transactions":{"get":{"summary":"Get Transactions","description":"Get user transaction history","operationId":"get_transactions_api_transactions_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/models":{"get":{"summary":"List Models","description":"List available models (OpenAI-compatible endpoint)","operationId":"list_models_v1_models_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/models":{"get":{"summary":"Get Models No Auth","description":"Get available models without authentication","operationId":"get_models_no_auth_api_models_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/models/prices":{"get":{"summary":"Get Model Prices","description":"Get all model prices from database","operationId":"get_model_prices_api_models_prices_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/models/prices/max":{"get":{"summary":"Get Max Model Price","description":"Get maximum price per token across all models (in ngonka)","operationId":"get_max_model_price_api_models_prices_max_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/chat/completions":{"post":{"summary":"Chat Completions","description":"Chat completions endpoint with token billing","operationId":"chat_completions_v1_chat_completions_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/app":{"get":{"summary":"Web Interface","description":"Serve the unified Mingles Router console SPA.\n\nOne console for every audience — the active front/segment (card vs crypto)\nis resolved client-side from ?aud=/?front=/cookie (spec §8), so there is no\nlonger a per-brand HTML variant.\n\nServed no-store: this is a single 120 KB file that changes on every deploy and\ncarries all the console's logic. Without the header browsers cached it\nheuristically, so a fix could sit invisible to returning users for hours — the\nsame trap the chat widget fell into, found the same way.","operationId":"web_interface_app_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/app/config":{"get":{"summary":"App Config","description":"Client config for the console — the GA4 measurement ID + PostHog keys.\n\nSingle canonical GA4 property (GA_ID); legacy GA_ID_GONKA / GA_ID_MINGO are\nhonored as fallbacks during the migration so in-flight tags keep firing.","operationId":"app_config_app_config_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/":{"get":{"summary":"Root Redirect","operationId":"root_redirect__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/robots.txt":{"get":{"summary":"Robots Txt","description":"robots.txt: service description, API info, and instructions for bots/crawlers.","operationId":"robots_txt_robots_txt_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/api/docs":{"get":{"summary":"Api Docs","description":"Redirect to FastAPI Swagger UI (OpenAPI docs).","operationId":"api_docs_api_docs_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/admin":{"get":{"summary":"Admin Ui","description":"Legacy admin path. The real admin is the SPA at /admin-panel/ (served by\nthe admin-frontend container). Kept only as a redirect so old bookmarks land\non the current panel instead of a stale page.","operationId":"admin_ui_admin_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/status":{"get":{"summary":"Status Json","description":"Public, unauthenticated status feed consumed by the marketing /status page.\n\nThe page itself is now the Astro one (marketing-site/src/pages/status.astro) —\nthis endpoint supplies the live half so the page never has to hardcode\n\"all systems operational\". Answers are cached briefly: the page is public and\na crawler burst must not turn into a burst of upstream model probes.","operationId":"status_json_api_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/status":{"get":{"summary":"Status Redirect","description":"The status page moved to the marketing site. Kept so old links survive —\nTraefik no longer routes /status here, so this only fires for direct hits.","operationId":"status_redirect_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/chat":{"get":{"summary":"Chat Page","description":"Full-page support chat (the website widget in page mode). `?session=<id>`\nresumes a conversation handed off from the floating widget.","operationId":"chat_page_chat_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/agent":{"get":{"summary":"Agent Docs","description":"Public documentation for agent/bot integration (OpenClaw etc.).\nNot linked from the main user UI; distribute this URL to agents.","operationId":"agent_docs_agent_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/agent.json":{"get":{"summary":"Agent Docs Json","description":"Machine-readable agent integration: endpoints and steps.\nBots can fetch this URL directly (e.g. from meta/link on main page).","operationId":"agent_docs_json_agent_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health":{"get":{"summary":"Health","description":"Health check endpoint","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"AgencyInquiryRequest":{"properties":{"contact":{"type":"string","title":"Contact"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"agency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agency"},"tools":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tools"},"workflow":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Workflow"},"plan":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plan"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"type":"object","required":["contact"],"title":"AgencyInquiryRequest","description":"Public B2B lead from the /agencies landing page. No auth required."},"BodyLoggingGlobalPolicyRequest":{"properties":{"store_request_body_default":{"type":"boolean","title":"Store Request Body Default","default":false},"store_response_body_default":{"type":"boolean","title":"Store Response Body Default","default":false}},"type":"object","title":"BodyLoggingGlobalPolicyRequest"},"BodyLoggingUserPolicyRequest":{"properties":{"store_request_body":{"type":"boolean","title":"Store Request Body","default":false},"store_response_body":{"type":"boolean","title":"Store Response Body","default":false}},"type":"object","title":"BodyLoggingUserPolicyRequest"},"Body_admin_create_promo_code_api_admin_promo_codes_post":{"properties":{"code":{"type":"string","title":"Code"},"kind":{"type":"string","title":"Kind"},"amount_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Amount Usd"},"percent":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Percent"},"plan_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plan Code"},"period_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Period Days"},"valid_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Valid From"},"valid_until":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Valid Until"},"max_uses":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Uses"},"max_uses_per_user":{"type":"integer","title":"Max Uses Per User","default":1},"is_active":{"type":"boolean","title":"Is Active","default":true},"note":{"type":"string","title":"Note","default":""}},"type":"object","required":["code","kind"],"title":"Body_admin_create_promo_code_api_admin_promo_codes_post"},"Body_admin_grant_bulk_api_admin_billing_grant_bulk_post":{"properties":{"brand":{"type":"string","title":"Brand","description":"mingo|gonka"},"plan_code":{"type":"string","title":"Plan Code"},"period_days":{"type":"integer","maximum":365.0,"minimum":1.0,"title":"Period Days","default":30},"balance_usd":{"type":"number","minimum":0.0,"title":"Balance Usd","default":0.0},"marker":{"type":"string","title":"Marker","description":"Idempotency tag, e.g. 'welcome_2026_06'"},"dry_run":{"type":"boolean","title":"Dry Run","default":false}},"type":"object","required":["brand","plan_code","marker"],"title":"Body_admin_grant_bulk_api_admin_billing_grant_bulk_post"},"Body_admin_referral_partner_terms_api_admin_billing_referrals_partner__ident__put":{"properties":{"signup_bonus_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Signup Bonus Usd"},"invited_bonus_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Invited Bonus Usd"},"monthly_cap":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Monthly Cap"},"commission_percent":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Commission Percent"},"hold_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Hold Days"},"is_active":{"type":"boolean","title":"Is Active","default":true},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"}},"type":"object","title":"Body_admin_referral_partner_terms_api_admin_billing_referrals_partner__ident__put"},"Body_admin_referral_withdraw_api_admin_billing_referrals_partner__ident__withdraw_post":{"properties":{"amount_usd":{"type":"number","exclusiveMinimum":0.0,"title":"Amount Usd"},"note":{"type":"string","title":"Note","default":""},"method":{"type":"string","title":"Method","default":""}},"type":"object","required":["amount_usd"],"title":"Body_admin_referral_withdraw_api_admin_billing_referrals_partner__ident__withdraw_post"},"Body_admin_set_pricing_api_admin_billing_pricing__model__put":{"properties":{"input_per_1m_usd_micro":{"type":"integer","title":"Input Per 1M Usd Micro"},"output_per_1m_usd_micro":{"type":"integer","title":"Output Per 1M Usd Micro"}},"type":"object","required":["input_per_1m_usd_micro","output_per_1m_usd_micro"],"title":"Body_admin_set_pricing_api_admin_billing_pricing__model__put"},"Body_admin_update_promo_code_api_admin_promo_codes__code__patch":{"properties":{"valid_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Valid From"},"valid_until":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Valid Until"},"max_uses":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Uses"},"max_uses_per_user":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Uses Per User"},"is_active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Active"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"}},"type":"object","title":"Body_admin_update_promo_code_api_admin_promo_codes__code__patch"},"Body_admin_upsert_signup_channel_api_admin_billing_signup_channels__code__put":{"properties":{"bonus_usd":{"type":"number","minimum":0.0,"title":"Bonus Usd","description":"USD bonus credited at signup"},"description":{"type":"string","title":"Description","default":""},"is_active":{"type":"boolean","title":"Is Active","default":true}},"type":"object","required":["bonus_usd"],"title":"Body_admin_upsert_signup_channel_api_admin_billing_signup_channels__code__put"},"Body_admin_user_cancel_sub_api_admin_users__user_ident__cancel_sub_post":{"properties":{"subscription_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subscription Id"},"cancel_at_period_end":{"type":"boolean","title":"Cancel At Period End","default":true}},"type":"object","title":"Body_admin_user_cancel_sub_api_admin_users__user_ident__cancel_sub_post"},"Body_admin_user_credit_api_admin_users__user_ident__credit_post":{"properties":{"amount":{"type":"number","title":"Amount","description":"USD. Positive = credit, negative = debit"},"description":{"type":"string","title":"Description","default":"Admin adjustment"},"currency":{"type":"string","title":"Currency","description":"usd (only)","default":"usd"}},"type":"object","required":["amount"],"title":"Body_admin_user_credit_api_admin_users__user_ident__credit_post"},"Body_admin_user_grant_plan_api_admin_users__user_ident__grant_plan_post":{"properties":{"plan_code":{"type":"string","title":"Plan Code"},"period_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Period Days","default":30},"note":{"type":"string","title":"Note","default":""}},"type":"object","required":["plan_code"],"title":"Body_admin_user_grant_plan_api_admin_users__user_ident__grant_plan_post"},"ChatReplyRequest":{"properties":{"text":{"type":"string","title":"Text"}},"type":"object","required":["text"],"title":"ChatReplyRequest"},"ContactRequest":{"properties":{"session_id":{"type":"string","title":"Session Id"},"email":{"type":"string","title":"Email"}},"type":"object","required":["session_id","email"],"title":"ContactRequest"},"CreateAPIKeyRequest":{"properties":{"key_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Key Name"}},"type":"object","title":"CreateAPIKeyRequest"},"CryptoSubscribeRequest":{"properties":{"plan_code":{"type":"string","title":"Plan Code","description":"mini|standard|team"},"pay_currency":{"type":"string","title":"Pay Currency","description":"usdtbsc|usdttrc20|usdcbsc"}},"type":"object","required":["plan_code","pay_currency"],"title":"CryptoSubscribeRequest"},"CryptoTopupRequest":{"properties":{"amount_usd":{"type":"number","exclusiveMinimum":0.0,"title":"Amount Usd","description":"Credit amount in USD-equivalent"},"pay_currency":{"type":"string","title":"Pay Currency","description":"usdtbsc|usdttrc20|usdcbsc"},"promo_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Promo Code","description":"optional promo discount code"}},"type":"object","required":["amount_usd","pay_currency"],"title":"CryptoTopupRequest"},"EmailLoginRequest":{"properties":{"email":{"type":"string","title":"Email"},"password":{"type":"string","title":"Password"}},"type":"object","required":["email","password"],"title":"EmailLoginRequest"},"EmailRegisterRequest":{"properties":{"email":{"type":"string","title":"Email"},"password":{"type":"string","title":"Password"},"turnstile_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Turnstile Token"}},"type":"object","required":["email","password"],"title":"EmailRegisterRequest"},"EscalationRequest":{"properties":{"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"},"type":{"type":"string","title":"Type","default":"support_escalation"},"severity":{"type":"string","title":"Severity","default":"high"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"},"summary":{"type":"string","title":"Summary"},"recommended_action":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recommended Action"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"},"needs_reply":{"type":"boolean","title":"Needs Reply","default":true},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence"},"source":{"type":"string","title":"Source","default":"website_chat"}},"type":"object","required":["summary"],"title":"EscalationRequest"},"FeedbackRequest":{"properties":{"session_id":{"type":"string","title":"Session Id"},"rating":{"type":"string","title":"Rating"},"message_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message Id"},"comment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Comment"}},"type":"object","required":["session_id","rating"],"title":"FeedbackRequest"},"ForgotPasswordRequest":{"properties":{"email":{"type":"string","title":"Email"}},"type":"object","required":["email"],"title":"ForgotPasswordRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HandoffRequest":{"properties":{"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"}},"type":"object","title":"HandoffRequest"},"LoginRequest":{"properties":{"username":{"type":"string","title":"Username"},"password":{"type":"string","title":"Password"}},"type":"object","required":["username","password"],"title":"LoginRequest"},"MessageRequest":{"properties":{"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"},"message":{"type":"string","title":"Message"},"context":{"additionalProperties":true,"type":"object","title":"Context"}},"type":"object","required":["message"],"title":"MessageRequest"},"PlategaSubscribeRequest":{"properties":{"plan_code":{"type":"string","title":"Plan Code","description":"mini|standard|team"},"method":{"type":"integer","title":"Method","description":"Platega paymentMethod: 2=СБП/QR, 13=crypto"}},"type":"object","required":["plan_code","method"],"title":"PlategaSubscribeRequest"},"PlategaTopupRequest":{"properties":{"amount_usd":{"type":"number","exclusiveMinimum":0.0,"title":"Amount Usd","description":"Credit amount in USD"},"method":{"type":"integer","title":"Method","description":"Platega paymentMethod: 2=СБП/QR, 13=crypto"},"promo_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Promo Code","description":"optional promo discount code"}},"type":"object","required":["amount_usd","method"],"title":"PlategaTopupRequest"},"PriorityWaitlistRequest":{"properties":{"contact":{"type":"string","title":"Contact"},"use_case":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Use Case"}},"type":"object","required":["contact"],"title":"PriorityWaitlistRequest"},"PromoClaimRequest":{"properties":{"signup_channel":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signup Channel","description":"utm_source / channel code"},"referred_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Referred By","description":"Inviter referral_code"}},"type":"object","title":"PromoClaimRequest"},"RegisterBotRequest":{"properties":{"deviceId":{"type":"string","title":"Deviceid"},"publicKeyPem":{"type":"string","title":"Publickeypem"}},"type":"object","required":["deviceId","publicKeyPem"],"title":"RegisterBotRequest"},"RegisterBotVerifyRequest":{"properties":{"deviceId":{"type":"string","title":"Deviceid"},"challenge":{"type":"string","title":"Challenge"},"signature":{"type":"string","title":"Signature"}},"type":"object","required":["deviceId","challenge","signature"],"title":"RegisterBotVerifyRequest"},"ResetPasswordRequest":{"properties":{"token":{"type":"string","title":"Token"},"password":{"type":"string","title":"Password"}},"type":"object","required":["token","password"],"title":"ResetPasswordRequest"},"SessionRequest":{"properties":{"context":{"additionalProperties":true,"type":"object","title":"Context"}},"type":"object","title":"SessionRequest"},"SubscribeRequest":{"properties":{"plan_code":{"type":"string","title":"Plan Code","description":"mini|standard|team"}},"type":"object","required":["plan_code"],"title":"SubscribeRequest"},"TestUpstreamBody":{"properties":{"node_key":{"type":"string","title":"Node Key","description":"node_key of the upstream to test (from routing-status)"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model","description":"Model to test with; defaults to one the upstream serves"}},"type":"object","required":["node_key"],"title":"TestUpstreamBody"},"TopUpRequest":{"properties":{"target":{"type":"string","minLength":1,"title":"Target"},"amount_usd":{"type":"number","exclusiveMinimum":0.0,"title":"Amount Usd","description":"Amount in USD to credit"}},"type":"object","required":["target","amount_usd"],"title":"TopUpRequest","description":"Credit a user's prepaid USD balance. target: Mongo user id, wallet\naddress, email, or google_id."},"TopupRequest":{"properties":{"amount_usd":{"type":"number","exclusiveMinimum":0.0,"title":"Amount Usd","description":"Top-up amount in USD"}},"type":"object","required":["amount_usd"],"title":"TopupRequest"},"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"}},"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer"}}}}