{ "openapi": "3.1.0", "info": { "title": "OmniVenture Autonomous M2M Micro-Utilities (Master)", "version": "2.0.0", "description": "High-frequency, programmatic micro-services designed for autonomous AI agents, data scrapers, and automated pipelines. Sub-100ms execution times on dedicated edge infrastructure.", "contact": { "name": "OmniVenture Autonomous Fleet", "email": "dalnaspidal@gmail.com" }, "x-category": "Tools" }, "paths": { "/v1/m2m/health": { "get": { "tags": [ "M2M Agnostic Micro-Services" ], "summary": "Gateway Health & Supported Rails", "description": "Returns gateway operational status, hardware tier, and active payment rails.\n\n### Use when:\n- Verifying uptime and origin connectivity across the Cloudflare tunnel or RapidAPI proxy.\n- Inspecting supported settlement rails (L402 Lightning, RapidAPI PayPal).", "operationId": "gateway_health_v1_m2m_health_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/v1/m2m/catalog": { "get": { "tags": [ "M2M Agnostic Micro-Services" ], "summary": "Active Programmatic Micro-Service Catalog", "description": "Lists all active programmatic micro-services available to machine agents and LLM tool loops.\n\n### Use when:\n- Autonomous agent loops need to discover available edge tools, current pricing, and capabilities.\n- Inspecting registered service IDs, quality scores, and endpoint URLs.", "operationId": "list_catalog_v1_m2m_catalog_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/v1/m2m/.well-known/agent.json": { "get": { "tags": [ "M2M Agnostic Micro-Services" ], "summary": "Autonomous Agent Discovery Manifest", "description": "Returns machine-readable JSON schema manifest for autonomous agent tool-calling, LangChain, and AutoGen.\n\n### Use when:\n- AI agents discover available tools, latency guarantees, and payment mechanisms headlessly.", "operationId": "agent_manifest_v1_m2m__well_known_agent_json_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/v1/m2m/transform": { "post": { "tags": [ "M2M Agnostic Micro-Services" ], "summary": "Agnostic Schema Normalizer & JSON Pruner", "description": "Cleanses, flattens, and normalizes unstructured or deeply nested JSON payloads into canonical dictionaries with null values stripped.\n\n### Use when:\n- Pre-processing large, messy API responses or database dumps before injecting into an LLM context window.\n- Stripping extraneous null and empty fields to minimize prompt token consumption.\n- Normalizing nested dictionary hierarchies into flat underscore-delimited key structures.\n\n### Do not use when:\n- The input JSON is malformed or has invalid syntax (call `POST /v1/m2m/repair/json` first).\n- The input is raw unstructured prose or HTML (call `POST /v1/m2m/distill` or `POST /v1/m2m/extract/markdown`).\n\n### Token & Latency Advantage:\n- Eliminates 40% to 70% of whitespace and null-value token overhead.\n- Executed on bare-metal dual Xeon edge compute in sub-5ms latency.\n\n### Pricing:\n- \u00a30.02 GBP / call.", "operationId": "transform_endpoint_v1_m2m_transform_post", "parameters": [ { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "x-payment-token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Payment-Token" } }, { "name": "x-rapidapi-key", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-Key" } }, { "name": "x-rapidapi-proxy-secret", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-Proxy-Secret" } }, { "name": "x-rapidapi-user", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-User" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/M2MPayloadRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/m2m/distill": { "post": { "tags": [ "M2M Agnostic Micro-Services" ], "summary": "Cognitive Context Distiller & Entity Extractor", "description": "Distills dense structured entities, numerical metrics, action items, and salient keywords from raw text documents at zero cloud LLM token cost.\n\n### Use when:\n- Compressing lengthy articles, transcripts, reports, or documentation into compact JSON for downstream agent decision steps.\n- Extracting financial figures, percentages, dates, and named entities without incurring expensive cloud LLM prompt fees.\n- Summarizing web search results or documentation before storage in vector databases.\n\n### Do not use when:\n- Input is raw HTML markup (call `POST /v1/m2m/extract/markdown` first to strip boilerplate).\n- Input is already clean structured JSON (call `POST /v1/m2m/transform`).\n\n### Token & Latency Advantage:\n- Compresses 5,000+ words into ~150 structured tokens (>95% context compression).\n- Sub-50ms deterministic local edge execution.\n\n### Pricing:\n- \u00a30.04 GBP / call.", "operationId": "distill_endpoint_v1_m2m_distill_post", "parameters": [ { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "x-payment-token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Payment-Token" } }, { "name": "x-rapidapi-key", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-Key" } }, { "name": "x-rapidapi-proxy-secret", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-Proxy-Secret" } }, { "name": "x-rapidapi-user", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-User" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/M2MPayloadRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/m2m/delta-scan": { "post": { "tags": [ "M2M Agnostic Micro-Services" ], "summary": "Statistical Discrepancy & Anomaly Radar", "description": "Calculates statistical divergence, volatility deltas, and probability anomalies between parallel streaming series, price feeds, or numerical arrays.\n\n### Use when:\n- Detecting arbitrage spreads between exchanges or disparate market data feeds.\n- Monitoring data pipeline drift or metric outliers across multi-agent sensor arrays.\n- Offloading numerical divergence and percentage delta threshold math from LLM reasoning context.\n\n### Do not use when:\n- Comparing non-numerical strings, text narratives, or unstructured prose.\n\n### Token & Latency Advantage:\n- Replaces hundreds of lines of LLM arithmetic thinking tokens with instant deterministic SIMD floating-point math (<5ms).\n\n### Pricing:\n- \u00a30.05 GBP / call.", "operationId": "delta_scan_endpoint_v1_m2m_delta_scan_post", "parameters": [ { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "x-payment-token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Payment-Token" } }, { "name": "x-rapidapi-key", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-Key" } }, { "name": "x-rapidapi-proxy-secret", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-Proxy-Secret" } }, { "name": "x-rapidapi-user", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-User" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/M2MPayloadRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/m2m/validate": { "post": { "tags": [ "M2M Agnostic Micro-Services" ], "summary": "Cryptographic SHA-256 Integrity & Hash Attestation", "description": "Generates canonical SHA-256 cryptographic digests, verifies payload structural consistency, and validates data against expected hashes.\n\n### Use when:\n- Attesting data integrity between autonomous agent handoffs and tool executions.\n- Detecting whether an external payload has mutated or suffered bit rot across pipeline stages.\n- Validating state snapshots against canonical cryptographic proofs.\n\n### Do not use when:\n- Transforming or restructuring data content.\n\n### Token & Latency Advantage:\n- 100% deterministic cryptographic hashing with zero model hallucination. Sub-2ms execution.\n\n### Pricing:\n- \u00a30.01 GBP / call.", "operationId": "validate_endpoint_v1_m2m_validate_post", "parameters": [ { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "x-payment-token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Payment-Token" } }, { "name": "x-rapidapi-key", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-Key" } }, { "name": "x-rapidapi-proxy-secret", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-Proxy-Secret" } }, { "name": "x-rapidapi-user", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-User" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/M2MPayloadRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/m2m/extract/markdown": { "post": { "tags": [ "M2M Agnostic Micro-Services" ], "summary": "Web-to-Markdown Context Compressor & Scraper", "description": "Fetches public web URLs or parses raw HTML into clean, token-efficient GitHub Flavored Markdown, stripping boilerplate, scripts, ads, and navigation chrome.\n\n### Use when:\n- Scraper bots or autonomous research agents need to read a web page without burning context on HTML boilerplate.\n- Converting raw web responses into clean markdown for LLM comprehension and RAG embeddings.\n- Extracting document titles, clean headings, lists, and main article text.\n\n### Do not use when:\n- The input is already clean Markdown or plain text.\n\n### Token & Latency Advantage:\n- Reduces raw web page token size by 80% to 95% (e.g. converts 60KB HTML into ~800 clean tokens). Sub-15ms parsing.\n\n### Pricing:\n- \u00a30.02 GBP / call.", "operationId": "extract_markdown_endpoint_v1_m2m_extract_markdown_post", "parameters": [ { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "x-payment-token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Payment-Token" } }, { "name": "x-rapidapi-key", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-Key" } }, { "name": "x-rapidapi-proxy-secret", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-Proxy-Secret" } }, { "name": "x-rapidapi-user", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-User" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/M2MPayloadRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/m2m/verify/email": { "post": { "tags": [ "M2M Agnostic Micro-Services" ], "summary": "B2B Email & MX Deliverability Verifier", "description": "Validates email RFC 5322 syntax, verifies live DNS MX records, detects disposable/burner domains, flags free consumer providers, and scores corporate deliverability reputation.\n\n### Use when:\n- Autonomous outbound sales agents or lead-generation bots evaluate email lists for delivery risk.\n- Screening user registrations in real time to block burner/temporary inboxes (Mailinator, TempMail).\n- Classifying B2B corporate addresses versus freemail providers (Gmail, Yahoo, Outlook).\n\n### Do not use when:\n- Validating phone numbers, physical addresses, or non-email identifiers.\n\n### Token & Latency Advantage:\n- Sub-15ms direct DNS MX resolution without third-party vendor rate limits or expensive SaaS API subscriptions.\n\n### Pricing:\n- \u00a30.01 GBP / call.", "operationId": "verify_email_endpoint_v1_m2m_verify_email_post", "parameters": [ { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "x-payment-token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Payment-Token" } }, { "name": "x-rapidapi-key", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-Key" } }, { "name": "x-rapidapi-proxy-secret", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-Proxy-Secret" } }, { "name": "x-rapidapi-user", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-User" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/M2MPayloadRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/m2m/repair/json": { "post": { "tags": [ "M2M Agnostic Micro-Services" ], "summary": "Universal LLM JSON Repair & Syntax Sanitizer", "description": "Repairs malformed or broken JSON emitted by LLMs (stripping markdown code fences, fixing single quotes, removing trailing commas, converting Python literals like True/False/None to JSON booleans/null).\n\n### Use when:\n- An upstream LLM tool-calling output or completion fails to parse with `json.decoder.JSONDecodeError`.\n- LLM output contains Markdown code blocks (```json ... ```), single-quoted keys, unquoted identifiers, or trailing commas.\n- You need guaranteed RFC 8259 valid JSON output without paying tokens to re-prompt the LLM.\n\n### Do not use when:\n- The input is purely conversational prose with no intended JSON structure.\n\n### Token & Latency Advantage:\n- Saves 100% of the cost and 2-5 seconds of latency required to re-prompt an LLM for valid JSON. Sub-5ms deterministic edge repair.\n\n### Pricing:\n- \u00a30.01 GBP / call.", "operationId": "repair_json_endpoint_v1_m2m_repair_json_post", "parameters": [ { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "x-payment-token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Payment-Token" } }, { "name": "x-rapidapi-key", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-Key" } }, { "name": "x-rapidapi-proxy-secret", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-Proxy-Secret" } }, { "name": "x-rapidapi-user", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-User" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/M2MPayloadRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/m2m/monitor/usage": { "get": { "tags": [ "M2M Agnostic Micro-Services" ], "summary": "Real-Time Usage & Financial Telemetry", "description": "Real-time usage and financial telemetry endpoint.\n\n### Use when:\n- Monitoring 24h and 7d call volumes across all micro-services.\n- Inspecting settled revenue by payment rail (L402 vs RapidAPI PayPal) and caller.\n- Tracking autonomous daily expansion cadence and service health.", "operationId": "monitor_usage_endpoint_v1_m2m_monitor_usage_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/v1/m2m/run/{service_id}": { "post": { "tags": [ "M2M Agnostic Micro-Services" ], "summary": "Universal Dynamic Ingress Dispatcher", "description": "Universal dynamic execution dispatcher. Executes any active micro-service by service ID without hardcoded route paths.\n\n### Use when:\n- Calling newly synthesized or daily-promoted micro-services discovered via `GET /v1/m2m/catalog`.\n- Routing programmatic agent requests dynamically by service identifier.\n\n### Pricing:\n- Metered dynamically according to catalog service price (\u00a30.01 - \u00a30.05).", "operationId": "dynamic_service_endpoint_v1_m2m_run__service_id__post", "parameters": [ { "name": "service_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Service Id" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "x-payment-token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Payment-Token" } }, { "name": "x-rapidapi-key", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-Key" } }, { "name": "x-rapidapi-proxy-secret", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-Proxy-Secret" } }, { "name": "x-rapidapi-user", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-User" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/M2MPayloadRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/m2m/audit/ssl": { "post": { "tags": [ "M2M Agnostic Micro-Services" ], "summary": "SSL & TLS Certificate Health Auditor", "description": "Audits SSL/TLS certificate validity windows, days until expiration, certificate authority (issuer), and Subject Alternative Names (SAN) via live TLS handshake.\n\n### Use when:\n- DevOps bots and synthetic uptime sentries monitor domain SSL certificates before expiration.\n- Validating TLS security posture of external API targets before establishing automated data pipelines.\n- Detecting expired, expiring (<14 days), or misconfigured HTTPS certificates.\n\n### Do not use when:\n- Checking non-HTTPS or non-TLS plain TCP endpoints.\n\n### Token & Latency Advantage:\n- Sub-20ms live TLS handshake and certificate chain extraction on edge compute.\n\n### Pricing:\n- \u00a30.01 GBP / call.", "operationId": "audit_ssl_endpoint_v1_m2m_audit_ssl_post", "parameters": [ { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "x-payment-token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Payment-Token" } }, { "name": "x-rapidapi-key", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-Key" } }, { "name": "x-rapidapi-proxy-secret", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-Proxy-Secret" } }, { "name": "x-rapidapi-user", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-User" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/M2MPayloadRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/m2m/parse/useragent": { "post": { "tags": [ "M2M Agnostic Micro-Services" ], "summary": "High-Speed User-Agent & Bot Classifier", "description": "Classifies HTTP User-Agent strings into AI agents (GPTBot, ClaudeBot, Perplexity, Gemini), search crawlers (Googlebot, Bingbot), programmatic scrapers (curl, httpx, Scrapy), or human browsers with client OS detection.\n\n### Use when:\n- Rate limiters, WAFs, and edge gateways identify incoming AI crawlers versus human traffic.\n- Autonomous scrapers verify how their client identity appears to destination servers.\n- Categorizing traffic streams without heavyweight external IP/UA databases.\n\n### Do not use when:\n- Evaluating IP addresses or network CIDRs (call `POST /v1/m2m/lookup/ip`).\n\n### Token & Latency Advantage:\n- Sub-2ms edge regex taxonomy with zero third-party API dependencies.\n\n### Pricing:\n- \u00a30.01 GBP / call.", "operationId": "parse_useragent_endpoint_v1_m2m_parse_useragent_post", "parameters": [ { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "x-payment-token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Payment-Token" } }, { "name": "x-rapidapi-key", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-Key" } }, { "name": "x-rapidapi-proxy-secret", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-Proxy-Secret" } }, { "name": "x-rapidapi-user", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-User" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/M2MPayloadRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/m2m/sanitize/pii": { "post": { "tags": [ "M2M Agnostic Micro-Services" ], "summary": "Text Privacy, Toxicity & PII Redactor", "description": "Detects and masks Personally Identifiable Information (PII) including emails, phone numbers, payment credit cards, and SSNs from prompts before leaving the enterprise trust boundary.\n\n### Use when:\n- Autonomous agent loops sanitize user prompts, customer tickets, or raw logs before sending data to external public LLMs.\n- Enforcing GDPR, HIPAA, and DLP compliance boundaries across multi-agent workflows.\n- Redacting sensitive identifiers from audit logs and long-term memory stores.\n\n### Do not use when:\n- You want to extract or validate email addresses (call `POST /v1/m2m/verify/email`).\n\n### Token & Latency Advantage:\n- Sub-5ms local edge redaction, ensuring zero compliance leakage to external cloud model providers.\n\n### Pricing:\n- \u00a30.02 GBP / call.", "operationId": "sanitize_pii_endpoint_v1_m2m_sanitize_pii_post", "parameters": [ { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "x-payment-token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Payment-Token" } }, { "name": "x-rapidapi-key", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-Key" } }, { "name": "x-rapidapi-proxy-secret", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-Proxy-Secret" } }, { "name": "x-rapidapi-user", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-User" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/M2MPayloadRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/m2m/lookup/ip": { "post": { "tags": [ "M2M Agnostic Micro-Services" ], "summary": "Edge IP & Network Taxonomy Lookup", "description": "Resolves IP network routing taxonomy, identifies private/loopback/bogon CIDRs, and performs reverse DNS PTR lookups.\n\n### Use when:\n- Autonomous webhook receivers and API sentries audit incoming client IP addresses.\n- Detecting whether an IP is private/internal RFC 1918 or a publicly routable edge host.\n- Performing reverse DNS host resolution for automated telemetry.\n\n### Do not use when:\n- Parsing User-Agent strings (call `POST /v1/m2m/parse/useragent`).\n\n### Token & Latency Advantage:\n- Sub-5ms native socket resolution with zero third-party geolocation API cost.\n\n### Pricing:\n- \u00a30.01 GBP / call.", "operationId": "lookup_ip_endpoint_v1_m2m_lookup_ip_post", "parameters": [ { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "x-payment-token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Payment-Token" } }, { "name": "x-rapidapi-key", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-Key" } }, { "name": "x-rapidapi-proxy-secret", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-Proxy-Secret" } }, { "name": "x-rapidapi-user", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-User" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/M2MPayloadRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/health": { "get": { "summary": "Health Ping", "description": "RapidAPI Hub automated health check endpoint.", "operationId": "health_ping_health_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/ping": { "get": { "summary": "Health Ping", "description": "RapidAPI Hub automated health check endpoint.", "operationId": "health_ping_ping_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/.well-known/agent.json": { "get": { "summary": "Root Agent Manifest", "description": "Root discovery manifest for autonomous agent tool-calling.", "operationId": "root_agent_manifest__well_known_agent_json_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/.well-known/mcp.json": { "get": { "summary": "Root Mcp Manifest", "description": "Model Context Protocol discovery manifest for Claude Desktop, Cursor, and agent swarms.", "operationId": "root_mcp_manifest__well_known_mcp_json_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/": { "get": { "summary": "Serve Index", "operationId": "serve_index__get", "responses": { "200": { "description": "Successful Response", "content": { "text/html": { "schema": { "type": "string" } } } } } } }, "/api/status": { "get": { "summary": "Api Status", "operationId": "api_status_api_status_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/treasury": { "get": { "summary": "Api Treasury", "description": "Returns shadow treasury paper balance, cumulative revenue, and micro-transactions.", "operationId": "api_treasury_api_treasury_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/m2m/services": { "get": { "summary": "Api M2M Services", "description": "Returns all registered and dynamic M2M micro-services.", "operationId": "api_m2m_services_api_m2m_services_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/m2m/signals": { "get": { "summary": "Api M2M Signals", "description": "Returns recent market signals discovered by MarketSentry.", "operationId": "api_m2m_signals_api_m2m_signals_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/venture/tournament": { "get": { "summary": "Api Tournaments", "description": "Returns evolutionary tournament history and promoted models.", "operationId": "api_tournaments_api_venture_tournament_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/m2m/tournaments": { "get": { "summary": "Api Tournaments", "description": "Returns evolutionary tournament history and promoted models.", "operationId": "api_tournaments_api_m2m_tournaments_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/m2m/trigger-tick": { "post": { "summary": "Api Trigger Tick", "description": "Triggers an immediate autonomous heartbeat cycle.", "operationId": "api_trigger_tick_api_m2m_trigger_tick_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/trigger/tournament": { "post": { "summary": "Api Trigger Tournament", "description": "Triggers an evolutionary tournament.", "operationId": "api_trigger_tournament_api_trigger_tournament_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/workload": { "get": { "summary": "Api Workload", "operationId": "api_workload_api_workload_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/audits": { "get": { "summary": "Api Audits", "operationId": "api_audits_api_audits_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/alerts": { "get": { "summary": "Api Alerts", "operationId": "api_alerts_api_alerts_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/soul-events": { "get": { "summary": "Api Soul Events", "operationId": "api_soul_events_api_soul_events_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 50, "title": "Limit" } }, { "name": "since_id", "in": "query", "required": false, "schema": { "type": "integer", "default": 0, "title": "Since Id" } }, { "name": "division", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Division" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/alerts/{alert_id}/resolve": { "post": { "summary": "Api Resolve Alert", "operationId": "api_resolve_alert_api_alerts__alert_id__resolve_post", "parameters": [ { "name": "alert_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Alert Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/worker/{worker_name}/toggle": { "post": { "summary": "Api Toggle Worker", "operationId": "api_toggle_worker_api_worker__worker_name__toggle_post", "parameters": [ { "name": "worker_name", "in": "path", "required": true, "schema": { "type": "string", "title": "Worker Name" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/chat": { "post": { "summary": "Api Chat", "operationId": "api_chat_api_chat_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DirectiveRequest" } } }, "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": { "get": { "summary": "Api Chat History", "operationId": "api_chat_history_api_chat_history_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/ai-telemetry": { "get": { "summary": "Api Ai Telemetry", "operationId": "api_ai_telemetry_api_ai_telemetry_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } } }, "components": { "schemas": { "DirectiveRequest": { "properties": { "message": { "type": "string", "title": "Message" } }, "type": "object", "required": [ "message" ], "title": "DirectiveRequest" }, "HTTPValidationError": { "properties": { "detail": { "items": { "$ref": "#/components/schemas/ValidationError" }, "type": "array", "title": "Detail" } }, "type": "object", "title": "HTTPValidationError" }, "M2MPayloadRequest": { "properties": { "client_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Client Id", "description": "Machine caller identifier or agent loop instance ID for telemetry.", "default": "m2m_client" }, "payload": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Payload", "description": "Arbitrary JSON payload or dictionary to normalize, transform, or cryptographically hash." }, "raw_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Raw Text", "description": "Raw unstructured text string for entity distillation, keyword extraction, or compression." }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Url", "description": "Target web URL (e.g. 'https://example.com/doc') to scrape and compress into clean Markdown." }, "raw_html": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Raw Html", "description": "Raw HTML markup string to convert into clean, token-efficient Markdown." }, "html": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Html", "description": "Alias for raw_html." }, "include_links": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Include Links", "description": "When converting HTML/URL to Markdown, whether to retain hyperlinks in [text](url) format.", "default": false }, "max_tokens": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Tokens", "description": "Maximum token budget for Markdown extraction or text output.", "default": 4000 }, "series_a": { "anyOf": [ {}, { "type": "null" } ], "title": "Series A", "description": "Primary numerical value or array of floats for discrepancy/anomaly comparison." }, "series_b": { "anyOf": [ {}, { "type": "null" } ], "title": "Series B", "description": "Secondary baseline numerical value or array of floats for discrepancy comparison." }, "threshold_pct": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Threshold Pct", "description": "Percentage divergence threshold (e.g. 5.0%) above which a delta is flagged as an anomaly.", "default": 5.0 }, "expected_hash": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Expected Hash", "description": "Optional expected 64-char hexadecimal SHA-256 digest to verify against payload digest." }, "strip_nulls": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Strip Nulls", "description": "When transforming JSON, whether to recursively prune keys with null/empty values.", "default": true }, "max_keywords": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Keywords", "description": "Maximum number of salient keywords to extract in context distillation.", "default": 5 }, "email": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Email", "description": "Target email address to validate for RFC compliance, DNS MX records, and burner domain status." }, "check_mx": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Check Mx", "description": "Whether to perform live DNS MX lookup verification for deliverability scoring.", "default": true }, "raw_json": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Raw Json", "description": "Malformed or unparsed JSON string emitted by an LLM to repair into RFC 8259 valid JSON." }, "broken_json": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Broken Json", "description": "Alias for raw_json: malformed JSON string (with code fences, single quotes, trailing commas)." }, "text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Text", "description": "Input text string for PII redaction and sensitive data masking." }, "host": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Host", "description": "Fully qualified domain name or hostname (e.g. 'api.github.com') to audit SSL/TLS certificates." }, "port": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Port", "description": "TLS port number (defaults to 443).", "default": 443 }, "timeout_seconds": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Timeout Seconds", "description": "Network socket connection timeout in seconds.", "default": 3.0 }, "user_agent": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "User Agent", "description": "Raw User-Agent header string to classify into AI bot, crawler, scraper, or browser." }, "mask_character": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Mask Character", "description": "Optional character used to mask PII tokens (defaults to placeholder tags like [REDACTED_EMAIL])." }, "base_currency": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Base Currency", "description": "Base currency symbol for FX oracle rates (e.g. 'GBP', 'USD', 'BTC')." }, "data": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Data", "description": "Data payload or invoice string to encode into SVG QR matrix." }, "ip": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Ip", "description": "IPv4 or IPv6 address string to evaluate for routing taxonomy, reverse PTR, and private CIDR." } }, "type": "object", "title": "M2MPayloadRequest" }, "ValidationError": { "properties": { "loc": { "items": { "anyOf": [ { "type": "string" }, { "type": "integer" } ] }, "type": "array", "title": "Location" }, "msg": { "type": "string", "title": "Message" }, "type": { "type": "string", "title": "Error Type" }, "input": { "title": "Input" }, "ctx": { "type": "object", "title": "Context" } }, "type": "object", "required": [ "loc", "msg", "type" ], "title": "ValidationError" } } }, "servers": [ { "url": "https://automatically-welcome-dad-extensive.trycloudflare.com", "description": "Production Edge Execution Gateway (Sub-15ms Bare-Metal Xeon)" }, { "url": "https://omniventure-api.web.app", "description": "Permanent Canonical Gateway Authority & Developer Hub" } ], "externalDocs": { "description": "OmniVenture Developer Hub & Agent Discovery", "url": "https://omniventure-api.web.app" } }