{ "openapi": "3.1.0", "info": { "title": "PreListProof API", "version": "0.1.0", "summary": "Marketplace compliance preflight, public verification, trust graph, and agent decision APIs.", "description": "PreListProof is fixed-fee decision support. It is not a certifier, laboratory, law firm, insurer, approval guarantee, or legal-compliance determination." }, "servers": [ { "url": "https://www.prelistproof.com" } ], "security": [ { "PreListProofApiKey": [] } ], "tags": [ { "name": "Public Records", "description": "Public verification, catalog, trust graph, and rejection-pattern endpoints." }, { "name": "Transparency", "description": "Hash-addressed public/private ledger checkpoint and inclusion-proof endpoints." }, { "name": "Embeds", "description": "Embeddable verification badges that point back to public evidence records." }, { "name": "Agent Decision", "description": "Decision support for agents before recommending, listing, sourcing, importing, or buying." }, { "name": "Platform", "description": "Fixed-fee API account creation and usage metering." }, { "name": "Integration Kits", "description": "Self-serve platform and connector onboarding contracts with duplicate-safe setup nudges." }, { "name": "Integration Conformance", "description": "Append-only partner self-test reports proving SDK, API, webhook, outcome, learning-loop, proof-network, and fixed-fee boundary readiness." }, { "name": "Trust Center", "description": "Self-serve security/procurement questionnaire answers generated from factual controls; no custom contract signing, legal advice, insurance, external audit claims, or approval guarantees." }, { "name": "SDK", "description": "Machine-readable integration pack with client snippets, webhook verification, event polling, outcome ingestion, and self-test steps." }, { "name": "Commercial Terms", "description": "Fixed-fee/no-finance terms snapshots and append-only acceptance receipts." }, { "name": "Revenue", "description": "Fixed-fee orders, payment-event ingestion, and fixed-fee/no-finance revenue ledger." }, { "name": "Receivables", "description": "Notice-only fixed-fee receivable reminders for pending orders; no auto-charge, interest, late fees, financing, insurance, certification, or approval guarantees." }, { "name": "Refunds", "description": "Append-only fixed-fee refund policy events and connector-ready payment_refunded instructions; no chargebacks, card handling, legal advice, certification, insurance, financing, or approval guarantees." }, { "name": "Autopilot", "description": "Seller intake, packet automation, exception-only ops, worker, outbox, and outcome listener endpoints." }, { "name": "Connectors", "description": "Unified connector inbox that routes external agent, mailbox, support, marketplace, forum, and research signals into the company loop." }, { "name": "Source Watchlist", "description": "Append-only watched public, policy, and case-source changes that materialize into source intelligence and rule-candidate learning without founder hand-work." }, { "name": "Channel Autopilot", "description": "Weekly connector-ready partner distribution plays generated from proof records, outcomes, integrations, source intelligence, source watchlist changes, and expansion radar without founder hand-writing." }, { "name": "Account Value", "description": "Notice-only fixed-fee renewal and expansion recaps derived from usage, integrations, proof records, outcomes, and channel responses." }, { "name": "Customer Success", "description": "Automatic safe support triage and connector-ready replies for routine fixed-fee billing, status, API, and support cases; routine refunds route to the refund policy worker while disputes, sensitive data, and liability-heavy requests stay human-required." }, { "name": "Portfolio Monitoring", "description": "Recurring record monitoring, outcome capture prompts, hard-blocker watch events, and connector-ready alerts." }, { "name": "Event Bus", "description": "Replayable event stream, webhook subscriptions, and connector-owned delivery rows for platform integrations." }, { "name": "Connector Dispatch", "description": "Unified delivery queue, leases, and acknowledgements for email and webhook connectors." }, { "name": "Connector Health", "description": "Append-only connector heartbeats, SLA incidents, and reliability worker checks before dispatch." }, { "name": "Claim Guard", "description": "Outbound and public copy audits that block unsafe certification, approval, insurance, finance, guarantee, and legal-compliance claims before connector dispatch." }, { "name": "Autonomy Health", "description": "Self-audit checks, health ledger, contract coverage, private-boundary checks, and operational invariants." }, { "name": "System Canary", "description": "Private non-polluting hourly canary checks for intake, packet analysis, agent learning, proof network, workflow distribution, event bus, and rule-pack boundaries." }, { "name": "Autonomous Runtime", "description": "Server-start daemon and duplicate-safe hourly runtime ticks that run the company loop and health worker without founder hand-work." }, { "name": "Company OS", "description": "Single-loop no-touch company orchestration for internal agents and schedulers." }, { "name": "Founder Updates", "description": "Hourly founder digest snapshots generated from company ledgers and stored in an append-only update ledger." }, { "name": "Lifecycle", "description": "Append-only dormancy and reopen policy for stale external waits after reminder coverage." }, { "name": "Expansion Radar", "description": "Data-driven marketplace/category wedge scoring from growth, revenue, proof, outcome, rule, and connector ledgers." }, { "name": "Agent Scheduler", "description": "No-touch worker orchestration for activation, fulfillment, and stale follow-ups." }, { "name": "Growth", "description": "Public demand signal intake, lead qualification, and fixed-fee outreach outbox." }, { "name": "Learning Loop", "description": "Versioned moat loop that materializes stored outcomes into trust-graph retrieval, promotion audits, and safe recommendations." }, { "name": "Outcome Calibration", "description": "Derived mismatch layer that compares preflight posture to stored marketplace outcomes and feeds agent decisions." }, { "name": "Rule Mining", "description": "Automatic candidate-rule intake, public rejection-pattern aggregation, and outcome-backed rule-promotion audits." }, { "name": "Rule Packs", "description": "Hash-addressed advisory rule-pack recommendation snapshots." }, { "name": "Rule Pack Releases", "description": "Append-only release-candidate gates derived from stored outcomes, trust-graph retrieval, promotion audits, claim guard, and advisory recommendations." } ], "paths": { "/api/agent/decision": { "get": { "tags": [ "Agent Decision" ], "summary": "Get an agent decision from query parameters.", "security": [ { "PreListProofApiKey": [] }, {} ], "parameters": [ { "name": "report_id", "in": "query", "schema": { "type": "string" }, "required": false }, { "name": "packet_sha256", "in": "query", "schema": { "type": "string" }, "required": false }, { "name": "marketplace", "in": "query", "schema": { "type": "string" }, "required": false }, { "name": "category", "in": "query", "schema": { "type": "string" }, "required": false }, { "name": "title", "in": "query", "schema": { "type": "string" }, "required": false }, { "name": "brand", "in": "query", "schema": { "type": "string" }, "required": false }, { "name": "model", "in": "query", "schema": { "type": "string" }, "required": false }, { "name": "listing_id", "in": "query", "schema": { "type": "string" }, "required": false }, { "name": "fcc_id", "in": "query", "schema": { "type": "string" }, "required": false }, { "name": "lab", "in": "query", "schema": { "type": "string" }, "required": false }, { "name": "standard", "in": "query", "schema": { "type": "string" }, "required": false }, { "name": "intended_action", "in": "query", "schema": { "type": "string" }, "required": false } ], "responses": { "200": { "description": "prelistproof.agent_decision.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.agent_decision.v1" } } } } } }, "401": { "description": "invalid_api_key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "invalid_api_key" } } } } } } } }, "post": { "tags": [ "Agent Decision" ], "summary": "Create an agent decision from product facts, report ID, or packet hash.", "security": [ { "PreListProofApiKey": [] }, {} ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "marketplace": "amazon_us", "category": "electronics", "title": "Aurora Mini Bluetooth Speaker", "brand": "AuroraGoods", "model": "AG-BT-210", "listing_id": "B0PRELISTPROOF", "fcc_id": "2AH25NT311H", "intended_action": "recommend" } } } }, "responses": { "200": { "description": "prelistproof.agent_decision.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.agent_decision.v1" } } } } } }, "401": { "description": "invalid_api_key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "invalid_api_key" } } } } } } } } }, "/api/platform/accounts": { "get": { "tags": [ "Platform" ], "summary": "List platform accounts without exposing API key secrets.", "responses": { "200": { "description": "prelistproof.platform_console.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.platform_console.v1" } } } } } } } }, "post": { "tags": [ "Platform" ], "summary": "Create a fixed-fee platform account and return a one-time API key.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "company": "Agentic Commerce Co", "email": "platform@example.com", "plan": "pilot", "use_case": "Agent recommends products before sourcing.", "accept_terms": true } } } }, "responses": { "201": { "description": "prelistproof.platform_account.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.platform_account.v1" } } } } } }, "400": { "description": "invalid_platform_account", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "invalid_platform_account" } } } } } } } } }, "/api/platform/keys": { "get": { "tags": [ "Platform", "SDK" ], "summary": "Read self-serve platform key lifecycle status without exposing API key hashes or secrets.", "parameters": [ { "name": "account_id", "in": "query", "schema": { "type": "string" }, "required": false } ], "responses": { "200": { "description": "prelistproof.platform_key_console.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.platform_key_console.v1" } } } } } } } }, "post": { "tags": [ "Platform", "SDK" ], "summary": "Rotate or revoke the current active platform API key without founder hand-work.", "security": [ { "PreListProofApiKey": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "action": "rotate", "account_id": "acct_...", "reason": "scheduled_rotation" } } } }, "responses": { "201": { "description": "prelistproof.platform_key_action_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.platform_key_action_result.v1" } } } } } }, "401": { "description": "invalid_or_revoked_api_key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "invalid_or_revoked_api_key" } } } } } }, "403": { "description": "account_key_mismatch", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "account_key_mismatch" } } } } } } } } }, "/api/platform/usage": { "get": { "tags": [ "Platform" ], "summary": "Read platform decision usage.", "parameters": [ { "name": "account_id", "in": "query", "schema": { "type": "string" }, "required": false } ], "responses": { "200": { "description": "prelistproof.platform_usage_report.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.platform_usage_report.v1" } } } } } } } } }, "/api/platform/quota": { "get": { "tags": [ "Platform" ], "summary": "Preview fixed-fee platform quota warning and pause jobs.", "responses": { "200": { "description": "prelistproof.platform_quota_worker.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.platform_quota_worker.v1" } } } } } } } } }, "/api/platform/quota/worker": { "get": { "tags": [ "Platform" ], "summary": "Preview fixed-fee platform quota warning and pause jobs.", "responses": { "200": { "description": "prelistproof.platform_quota_worker.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.platform_quota_worker.v1" } } } } } } } }, "post": { "tags": [ "Platform" ], "summary": "Queue duplicate-safe platform quota notices into the connector outbox.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "mode": "simulate", "limit": 50 } } } }, "responses": { "201": { "description": "prelistproof.platform_quota_worker_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.platform_quota_worker_result.v1" } } } } } } } } }, "/api/account-value": { "get": { "tags": [ "Account Value", "Platform", "Agent Scheduler" ], "summary": "Read account value records, fixed-fee renewal or expansion recommendations, and append-only value events.", "responses": { "200": { "description": "prelistproof.account_value_console.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.account_value_console.v1" } } } } } } } } }, "/api/account-value/worker": { "get": { "tags": [ "Account Value", "Agent Scheduler" ], "summary": "Preview duplicate-safe account value recap jobs.", "responses": { "200": { "description": "prelistproof.account_value_worker.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.account_value_worker.v1" } } } } } } } }, "post": { "tags": [ "Account Value", "Agent Scheduler" ], "summary": "Queue connector-ready fixed-fee value recaps and record append-only account value events.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "mode": "simulate", "limit": 50 } } } }, "responses": { "201": { "description": "prelistproof.account_value_worker_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.account_value_worker_result.v1" } } } } } } } } }, "/api/integrations": { "get": { "tags": [ "Integration Kits" ], "summary": "List self-serve integration kits and setup readiness.", "parameters": [ { "name": "kit_id", "in": "query", "schema": { "type": "string" }, "required": false } ], "responses": { "200": { "description": "prelistproof.integration_console.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.integration_console.v1" } } } } } } } }, "post": { "tags": [ "Integration Kits" ], "summary": "Create a fixed-fee integration setup kit for a marketplace, sourcing tool, procurement system, or connector agent.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "company": "Marketplace QA", "email": "integrations@example.com", "integration_type": "marketplace", "use_case": "Preflight listings before seller inventory goes live.", "endpoint_url": "https://example.com/prelistproof/webhooks", "event_types": [ "verification.report.created", "marketplace.outcome.recorded", "learning.loop.recorded", "rule_pack.recommendation.recorded", "rule_pack.release_candidate.recorded", "registry.refresh.recorded", "source.watchlist.recorded", "source.intelligence.recorded" ], "accept_terms": true } } } }, "responses": { "201": { "description": "prelistproof.integration_kit_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.integration_kit_result.v1" } } } } } }, "400": { "description": "invalid_integration_kit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "invalid_integration_kit" } } } } } } } } }, "/api/integrations/worker": { "get": { "tags": [ "Integration Kits" ], "summary": "Preview duplicate-safe integration setup nudges.", "responses": { "200": { "description": "prelistproof.integration_worker.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.integration_worker.v1" } } } } } } } }, "post": { "tags": [ "Integration Kits" ], "summary": "Queue duplicate-safe integration setup nudges into the connector outbox.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "mode": "simulate", "limit": 50 } } } }, "responses": { "201": { "description": "prelistproof.integration_worker_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.integration_worker_result.v1" } } } } } } } } }, "/api/integrations/conformance": { "get": { "tags": [ "Integration Conformance", "Integration Kits", "SDK" ], "summary": "Read append-only integration self-test reports and current conformance checks.", "parameters": [ { "name": "kit_id", "in": "query", "schema": { "type": "string" }, "required": false } ], "responses": { "200": { "description": "prelistproof.integration_conformance_console.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.integration_conformance_console.v1" } } } } } } } } }, "/api/integrations/conformance/worker": { "get": { "tags": [ "Integration Conformance" ], "summary": "Preview duplicate-safe integration conformance report jobs.", "responses": { "200": { "description": "prelistproof.integration_conformance_worker.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.integration_conformance_worker.v1" } } } } } } } }, "post": { "tags": [ "Integration Conformance" ], "summary": "Record duplicate-safe integration conformance events into the append-only event ledger.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "mode": "simulate", "limit": 50 } } } }, "responses": { "201": { "description": "prelistproof.integration_conformance_worker_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.integration_conformance_worker_result.v1" } } } } } } } } }, "/api/sdk": { "get": { "tags": [ "SDK", "Integration Kits", "Platform" ], "summary": "Read a generated SDK pack with safe client snippets, endpoints, webhook verification shape, outcome ingestion, and self-test steps.", "security": [ {} ], "parameters": [ { "name": "kit_id", "in": "query", "schema": { "type": "string" }, "required": false }, { "name": "account_id", "in": "query", "schema": { "type": "string" }, "required": false } ], "responses": { "200": { "description": "prelistproof.sdk_pack.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.sdk_pack.v1" } } } } } } } } }, "/api/terms": { "get": { "tags": [ "Commercial Terms" ], "summary": "Read the fixed-fee/no-finance terms snapshot and acceptance links.", "parameters": [ { "name": "subject_type", "in": "query", "schema": { "type": "string" }, "required": false }, { "name": "subject_id", "in": "query", "schema": { "type": "string" }, "required": false } ], "responses": { "200": { "description": "prelistproof.terms_console.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.terms_console.v1" } } } } } } } } }, "/api/terms/acceptances": { "get": { "tags": [ "Commercial Terms" ], "summary": "Read append-only fixed-fee terms acceptance receipts.", "responses": { "200": { "description": "prelistproof.terms_acceptance_console.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.terms_acceptance_console.v1" } } } } } } } } }, "/api/terms/acceptance": { "post": { "tags": [ "Commercial Terms" ], "summary": "Record a duplicate-safe terms acceptance receipt for an order, platform account, seller intake, or demo subject.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "subject_type": "order", "subject_id": "ord_...", "email": "buyer@example.com", "company": "Buyer Co", "accepted_terms": true, "source": "checkout_or_platform_onboarding" } } } }, "responses": { "201": { "description": "prelistproof.terms_acceptance_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.terms_acceptance_result.v1" } } } } } }, "400": { "description": "invalid_terms_acceptance", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "invalid_terms_acceptance" } } } } } } } } }, "/api/terms/followups": { "get": { "tags": [ "Commercial Terms" ], "summary": "Preview connector-ready reminder jobs for orders and platform accounts missing fixed-fee terms receipts.", "responses": { "200": { "description": "prelistproof.terms_followup_worker.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.terms_followup_worker.v1" } } } } } } } } }, "/api/terms/followups/worker": { "get": { "tags": [ "Commercial Terms" ], "summary": "Preview connector-ready reminder jobs for missing fixed-fee terms receipts.", "responses": { "200": { "description": "prelistproof.terms_followup_worker.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.terms_followup_worker.v1" } } } } } } } }, "post": { "tags": [ "Commercial Terms" ], "summary": "Queue duplicate-safe fixed-fee terms acceptance reminders into the connector outbox.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "mode": "simulate", "limit": 20 } } } }, "responses": { "201": { "description": "prelistproof.terms_followup_worker_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.terms_followup_worker_result.v1" } } } } } } } } }, "/api/orders": { "get": { "tags": [ "Revenue" ], "summary": "Read fixed-fee orders, payment events, revenue stats, and activation queue.", "responses": { "200": { "description": "prelistproof.revenue_console.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.revenue_console.v1" } } } } } } } }, "post": { "tags": [ "Revenue" ], "summary": "Create a fixed-fee order with no interest, lending, insurance, late fees, or approval guarantees.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "email": "seller@example.com", "company": "Seller Co", "plan": "priority_rejected_fix", "request_id": "rq_...", "idempotency_key": "request:rq_...", "accept_terms": true } } } }, "responses": { "201": { "description": "prelistproof.order.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.order.v1" } } } } } }, "400": { "description": "invalid_order", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "invalid_order" } } } } } } } } }, "/api/orders/payments": { "post": { "tags": [ "Revenue" ], "summary": "Ingest duplicate-safe payment connector events and unlock automatic fulfillment after payment.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "event_type": "payment_succeeded", "order_id": "ord_...", "provider_event_id": "evt_...", "amount_cents": 9900, "currency": "USD" } } } }, "responses": { "201": { "description": "prelistproof.payment_event.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.payment_event.v1" } } } } } }, "400": { "description": "invalid_payment_event", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "invalid_payment_event" } } } } } } } } }, "/api/checkout/stripe": { "get": { "tags": [ "Revenue" ], "summary": "Read Stripe hosted Checkout connector readiness without exposing secrets.", "security": [ {} ], "responses": { "200": { "description": "prelistproof.stripe_payment_connector.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.stripe_payment_connector.v1" } } } } } } } }, "post": { "tags": [ "Revenue" ], "summary": "Create a Stripe hosted Checkout Session for an unpaid fixed-fee order without handling card data.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "order_id": "ord_...", "success_url": "https://prelistproof.com/pricing?checkout=success", "cancel_url": "https://prelistproof.com/pricing?checkout=cancelled" } } } }, "responses": { "201": { "description": "prelistproof.stripe_checkout_session.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.stripe_checkout_session.v1" } } } } } }, "400": { "description": "invalid_stripe_checkout", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "invalid_stripe_checkout" } } } } } }, "503": { "description": "stripe_checkout_unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "stripe_checkout_unavailable" } } } } } } } } }, "/api/stripe/webhook": { "post": { "tags": [ "Revenue" ], "summary": "Verify Stripe webhook signatures and materialize Checkout payment results into the fixed-fee payment ledger.", "security": [ {} ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object" }, "example": { "id": "evt_...", "type": "checkout.session.completed", "data": { "object": { "client_reference_id": "ord_...", "payment_status": "paid", "amount_total": 9900, "currency": "usd" } } } } } }, "responses": { "201": { "description": "prelistproof.stripe_webhook_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.stripe_webhook_result.v1" } } } } } }, "200": { "description": "prelistproof.stripe_webhook_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.stripe_webhook_result.v1" } } } } } }, "400": { "description": "invalid_stripe_webhook", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "invalid_stripe_webhook" } } } } } }, "503": { "description": "stripe_webhook_unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "stripe_webhook_unavailable" } } } } } } } } }, "/api/receivables": { "get": { "tags": [ "Receivables", "Revenue", "Agent Scheduler" ], "summary": "Read notice-only fixed-fee receivable jobs and append-only notice events for pending orders.", "responses": { "200": { "description": "prelistproof.receivables_console.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.receivables_console.v1" } } } } } } } } }, "/api/receivables/worker": { "get": { "tags": [ "Receivables", "Agent Scheduler" ], "summary": "Preview duplicate-safe receivable notice jobs for pending fixed-fee orders.", "responses": { "200": { "description": "prelistproof.receivables_worker.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.receivables_worker.v1" } } } } } } } }, "post": { "tags": [ "Receivables", "Agent Scheduler", "Connector Dispatch" ], "summary": "Queue connector-ready fixed-fee receivable notices and record append-only notice events without charging cards or adding fees.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "mode": "simulate", "limit": 50 } } } }, "responses": { "201": { "description": "prelistproof.receivables_worker_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.receivables_worker_result.v1" } } } } } } } } }, "/api/trust-center": { "get": { "tags": [ "Trust Center", "SDK", "Connectors" ], "summary": "Read the self-serve trust center, factual controls, questionnaire events, and worker queue.", "responses": { "200": { "description": "prelistproof.security_trust_console.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.security_trust_console.v1" } } } } } } } } }, "/api/trust-center/worker": { "get": { "tags": [ "Trust Center", "Agent Scheduler", "Connector Dispatch" ], "summary": "Preview security/procurement questionnaire answer jobs from the trust-center ledger.", "responses": { "200": { "description": "prelistproof.security_trust_worker.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.security_trust_worker.v1" } } } } } } } }, "post": { "tags": [ "Trust Center", "Agent Scheduler", "Connector Dispatch" ], "summary": "Record factual trust-center answers and connector-ready responses without founder security-questionnaire hand-work.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "mode": "simulate", "limit": 20 } } } }, "responses": { "201": { "description": "prelistproof.security_trust_worker_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.security_trust_worker_result.v1" } } } } } } } } }, "/api/refunds": { "get": { "tags": [ "Refunds", "Revenue", "Customer Success", "Event Bus" ], "summary": "Read append-only fixed-fee refund policy events and current routine refund jobs.", "responses": { "200": { "description": "prelistproof.refund_policy_console.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.refund_policy_console.v1" } } } } } } } } }, "/api/refunds/worker": { "get": { "tags": [ "Refunds", "Agent Scheduler", "Connector Dispatch" ], "summary": "Preview routine refund policy jobs from customer success cases.", "responses": { "200": { "description": "prelistproof.refund_policy_worker.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.refund_policy_worker.v1" } } } } } } } }, "post": { "tags": [ "Refunds", "Agent Scheduler", "Connector Dispatch" ], "summary": "Record fixed-fee refund policy events and connector-ready payment_refunded instructions without founder hand-work.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "mode": "simulate", "limit": 20 } } } }, "responses": { "201": { "description": "prelistproof.refund_policy_worker_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.refund_policy_worker_result.v1" } } } } } } } } }, "/api/revenue": { "get": { "tags": [ "Revenue" ], "summary": "Alias for the private fixed-fee revenue console JSON.", "responses": { "200": { "description": "prelistproof.revenue_console.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.revenue_console.v1" } } } } } } } } }, "/api/revenue/worker": { "get": { "tags": [ "Revenue" ], "summary": "Preview paid fixed-fee activation jobs.", "responses": { "200": { "description": "prelistproof.revenue_worker.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.revenue_worker.v1" } } } } } } } }, "post": { "tags": [ "Revenue" ], "summary": "Run payment-gated and terms-gated activation jobs for seller autopilot or platform API accounts.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "mode": "simulate", "limit": 20 } } } }, "responses": { "201": { "description": "prelistproof.revenue_worker_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.revenue_worker_result.v1" } } } } } } } } }, "/api/company": { "get": { "tags": [ "Company OS" ], "summary": "Read the private founder-exception workload, business metrics, scheduler state, and recent loop ledger.", "responses": { "200": { "description": "prelistproof.company_os.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.company_os.v1" } } } } } } } } }, "/api/company/loop": { "get": { "tags": [ "Company OS" ], "summary": "Read the same Company OS state as /api/company for scheduler discovery.", "responses": { "200": { "description": "prelistproof.company_os.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.company_os.v1" } } } } } } } }, "post": { "tags": [ "Company OS" ], "summary": "Run the full no-touch company loop and persist an operating ledger event.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "mode": "simulate", "limit": 50, "minimum_age_hours": 72 } } } }, "responses": { "201": { "description": "prelistproof.company_loop_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.company_loop_result.v1" } } } } } } } } }, "/api/runtime": { "get": { "tags": [ "Autonomous Runtime", "Company OS", "Autonomy Health" ], "summary": "Read the private autonomous runtime console, daemon state, hourly tick ledger, and worker preview.", "responses": { "200": { "description": "prelistproof.runtime_console.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.runtime_console.v1" } } } } } } } } }, "/api/runtime/worker": { "get": { "tags": [ "Autonomous Runtime", "Company OS" ], "summary": "Preview whether this UTC hour needs a runtime tick.", "responses": { "200": { "description": "prelistproof.runtime_worker.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.runtime_worker.v1" } } } } } } } }, "post": { "tags": [ "Autonomous Runtime", "Company OS" ], "summary": "Run the company loop and autonomy health worker, then append one duplicate-safe runtime tick event. Decision support only; no certification, legal advice, insurance, financing, or approval guarantee.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "mode": "simulate", "limit": 100, "minimum_age_hours": 72, "force": false } } } }, "responses": { "201": { "description": "prelistproof.runtime_worker_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.runtime_worker_result.v1" } } } } } } } } }, "/api/ops/backups": { "get": { "tags": [ "Operations", "Company OS" ], "summary": "Read the append-only ledger backup console, current target posture, and recent backup manifest events.", "responses": { "200": { "description": "prelistproof.backup_console.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.backup_console.v1" } } } } } } } } }, "/api/ops/backups/worker": { "get": { "tags": [ "Operations", "Agent Scheduler" ], "summary": "Preview whether the current UTC day needs a ledger backup snapshot.", "responses": { "200": { "description": "prelistproof.backup_worker.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.backup_worker.v1" } } } } } } } }, "post": { "tags": [ "Operations", "Agent Scheduler" ], "summary": "Create a hash manifest and tarball for append-only ledgers, copy to mounted file targets when configured, and append a backup event.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "mode": "backup", "force": false } } } }, "responses": { "201": { "description": "prelistproof.backup_worker_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.backup_worker_result.v1" } } } } } } } } }, "/api/ops/alerts": { "get": { "tags": [ "Operations", "Autonomy Health" ], "summary": "Read failure-alert events and destination readiness without exposing webhook or admin-email values.", "responses": { "200": { "description": "prelistproof.alert_console.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.alert_console.v1" } } } } } } } } }, "/api/ops/alerts/worker": { "get": { "tags": [ "Operations", "Autonomy Health" ], "summary": "Preview deduplicated alerts for red health checks, launch blockers, and connector-health incidents.", "responses": { "200": { "description": "prelistproof.alert_worker.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.alert_worker.v1" } } } } } } } }, "post": { "tags": [ "Operations", "Autonomy Health" ], "summary": "Append deduplicated failure-alert events and send to a configured HTTPS webhook only in handoff mode.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "mode": "simulate", "limit": 20 } } } }, "responses": { "201": { "description": "prelistproof.alert_worker_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.alert_worker_result.v1" } } } } } } } } }, "/api/founder-updates": { "get": { "tags": [ "Founder Updates" ], "summary": "Read the hourly founder digest console, current preview, and recent append-only update events.", "responses": { "200": { "description": "prelistproof.founder_update_console.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.founder_update_console.v1" } } } } } } } } }, "/api/founder-updates/worker": { "get": { "tags": [ "Founder Updates" ], "summary": "Preview whether this UTC hour needs a founder digest event.", "responses": { "200": { "description": "prelistproof.founder_update_worker.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.founder_update_worker.v1" } } } } } } } }, "post": { "tags": [ "Founder Updates" ], "summary": "Record one duplicate-safe hourly founder digest from company ledgers.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "force": false } } } }, "responses": { "201": { "description": "prelistproof.founder_update_worker_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.founder_update_worker_result.v1" } } } } } } } } }, "/api/canary": { "get": { "tags": [ "System Canary", "Autonomy Health", "Company OS" ], "summary": "Read private append-only synthetic canary events and the current hourly worker preview.", "responses": { "200": { "description": "prelistproof.canary_console.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.canary_console.v1" } } } } } } } } }, "/api/canary/worker": { "get": { "tags": [ "System Canary", "Agent Scheduler" ], "summary": "Preview whether this UTC hour needs a private non-polluting moat canary event.", "responses": { "200": { "description": "prelistproof.canary_worker.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.canary_worker.v1" } } } } } } } }, "post": { "tags": [ "System Canary", "Agent Scheduler" ], "summary": "Run a private synthetic end-to-end moat canary and append a hash-addressed result without creating reports, outcomes, orders, revenue, or outbox rows.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "mode": "simulate", "force": false } } } }, "responses": { "201": { "description": "prelistproof.canary_worker_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.canary_worker_result.v1" } } } } } } } } }, "/api/dormancy": { "get": { "tags": [ "Lifecycle", "Company OS" ], "summary": "Read append-only parked lifecycle events and stale wait jobs.", "responses": { "200": { "description": "prelistproof.dormancy_console.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.dormancy_console.v1" } } } } } } } } }, "/api/dormancy/worker": { "get": { "tags": [ "Lifecycle", "Agent Scheduler" ], "summary": "Preview stale unpaid, missing-packet, and missing-outcome waits ready for append-only parking.", "responses": { "200": { "description": "prelistproof.dormancy_worker.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.dormancy_worker.v1" } } } } } } } }, "post": { "tags": [ "Lifecycle", "Agent Scheduler" ], "summary": "Park stale external waits in an append-only lifecycle ledger without deleting evidence or making certification, legal, insurance, finance, or approval-guarantee claims.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "mode": "simulate", "limit": 20, "dry_run": false } } } }, "responses": { "201": { "description": "prelistproof.dormancy_worker_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.dormancy_worker_result.v1" } } } } } } } } }, "/api/expansion": { "get": { "tags": [ "Expansion Radar" ], "summary": "Read the private expansion radar, current segment ranking, and recent append-only radar snapshots.", "responses": { "200": { "description": "prelistproof.expansion_radar_console.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.expansion_radar_console.v1" } } } } } } } } }, "/api/expansion/worker": { "get": { "tags": [ "Expansion Radar" ], "summary": "Preview whether the current expansion radar snapshot needs to be recorded.", "responses": { "200": { "description": "prelistproof.expansion_radar_worker.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.expansion_radar_worker.v1" } } } } } } } }, "post": { "tags": [ "Expansion Radar" ], "summary": "Record one duplicate-safe expansion radar snapshot without changing live rules, pricing, or claim boundaries.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "force": false } } } }, "responses": { "201": { "description": "prelistproof.expansion_radar_worker_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.expansion_radar_worker_result.v1" } } } } } } } } }, "/api/connectors/inbox": { "get": { "tags": [ "Connectors" ], "summary": "Read the unified connector inbox, route mix, and recent routing events.", "responses": { "200": { "description": "prelistproof.connector_inbox.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.connector_inbox.v1" } } } } } } } }, "post": { "tags": [ "Connectors" ], "summary": "Route an external connector signal into growth-source acquisition, seller intake, packet fulfillment, outcome capture, customer success, or rule mining, then optionally run the company loop.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "connector": "gmail_search_forum_or_marketplace_webhook", "route": "growth_source", "source_type": "forum_post", "subject": "Amazon rejected our Bluetooth speaker compliance packet", "body": "FCC ID is missing from the label photo and the lab-report model does not match the listing.", "marketplace": "amazon_us", "category": "electronics", "run_company_loop": true } } } }, "responses": { "201": { "description": "prelistproof.connector_route_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.connector_route_result.v1" } } } } } }, "202": { "description": "needs_review", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "needs_review" } } } } } } } } }, "/api/connectors/feeds": { "get": { "tags": [ "Connectors" ], "summary": "Read configured source feeds and recent automated feed sweeps.", "responses": { "200": { "description": "prelistproof.connector_feed_console.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.connector_feed_console.v1" } } } } } } } }, "post": { "tags": [ "Connectors" ], "summary": "Run a simulated connector-source sweep and route generated payloads through the unified inbox before running the company loop.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "mode": "simulate", "limit": 5, "sources": [ "public_search", "support_mailbox", "policy_monitor", "packet_dropbox", "marketplace_outcomes" ], "minimum_age_hours": 0 } } } }, "responses": { "201": { "description": "prelistproof.connector_feed_sweep_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.connector_feed_sweep_result.v1" } } } } } }, "202": { "description": "no_source_material", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "no_source_material" } } } } } } } } }, "/api/connectors/health": { "get": { "tags": [ "Connector Health", "Connectors", "Company OS" ], "summary": "Read append-only connector heartbeats, derived SLA status, and incident jobs.", "responses": { "200": { "description": "prelistproof.connector_health_console.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.connector_health_console.v1" } } } } } } } } }, "/api/connectors/heartbeat": { "post": { "tags": [ "Connector Health", "Connectors" ], "summary": "Record an append-only connector heartbeat without storing connector secrets.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "connector_id": "gmail-primary", "connector_type": "email", "channels": [ "email" ], "status": "ok", "mode": "live", "queue_depth": 0 } } } }, "responses": { "201": { "description": "prelistproof.connector_heartbeat_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.connector_heartbeat_result.v1" } } } } } }, "400": { "description": "invalid_connector_heartbeat", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "invalid_connector_heartbeat" } } } } } } } } }, "/api/connectors/health/worker": { "get": { "tags": [ "Connector Health", "Agent Scheduler" ], "summary": "Preview connector SLA incident jobs derived from dispatch and webhook queues.", "responses": { "200": { "description": "prelistproof.connector_health_worker.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.connector_health_worker.v1" } } } } } } } }, "post": { "tags": [ "Connector Health", "Agent Scheduler" ], "summary": "Record duplicate-safe connector health incidents for missing, stale, or degraded connector coverage.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "mode": "simulate", "limit": 50, "stale_after_minutes": 30 } } } }, "responses": { "201": { "description": "prelistproof.connector_health_worker_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.connector_health_worker_result.v1" } } } } } } } } }, "/api/connectors/delivery": { "get": { "tags": [ "Connectors", "Agent Scheduler", "Company OS" ], "summary": "Read live SMTP/webhook delivery connector readiness, dispatch summary, recent acknowledgements, and no-founder delivery contract.", "responses": { "200": { "description": "prelistproof.delivery_connector_console.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.delivery_connector_console.v1" } } } } } } } } }, "/api/connectors/delivery/worker": { "get": { "tags": [ "Connectors", "Agent Scheduler" ], "summary": "Preview claim-guarded email/webhook dispatch jobs that can be delivered by configured SMTP or signed webhook connectors.", "responses": { "200": { "description": "prelistproof.delivery_connector_worker.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.delivery_connector_worker.v1" } } } } } } } }, "post": { "tags": [ "Connectors", "Agent Scheduler" ], "summary": "Lease dispatch jobs and either simulate delivery locally or send through configured SMTP/webhook adapters in handoff/live mode, then append dispatch acknowledgements.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "mode": "simulate", "limit": 50, "channels": [ "email", "webhook" ] } } } }, "responses": { "201": { "description": "prelistproof.delivery_connector_worker_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.delivery_connector_worker_result.v1" } } } } } } } } }, "/api/source-intelligence": { "get": { "tags": [ "Connectors", "Expansion Radar", "Rule Mining" ], "summary": "Read append-only scored source-intelligence events created from connector feed sweeps.", "responses": { "200": { "description": "prelistproof.source_intelligence_console.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.source_intelligence_console.v1" } } } } } } } } }, "/api/source-watchlist": { "get": { "tags": [ "Source Watchlist", "Connectors", "Rule Mining", "Learning Loop" ], "summary": "Read append-only watched public/policy/case sources, recent materialization events, worker state, and liability boundaries.", "responses": { "200": { "description": "prelistproof.source_watchlist_console.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.source_watchlist_console.v1" } } } } } } } }, "post": { "tags": [ "Source Watchlist", "Connectors", "Rule Mining" ], "summary": "Create or update a watched source. Changed hashes are later routed through the connector inbox into source intelligence and candidate-rule mining.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "source_type": "policy", "route": "rule_candidate", "marketplace": "amazon_us", "category": "electronics", "title": "Repeated FCC model-bridge rejection language", "source_url": "https://example.test/policy/model-bridge", "source_excerpt": "RF products are blocked when FCC grant, lab report, label photo, and listing model do not form a clear model bridge." } } } }, "responses": { "201": { "description": "prelistproof.source_watchlist_item_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.source_watchlist_item_result.v1" } } } } } }, "400": { "description": "invalid_source_watchlist_item", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "invalid_source_watchlist_item" } } } } } } } } }, "/api/source-watchlist/worker": { "get": { "tags": [ "Source Watchlist", "Agent Scheduler" ], "summary": "Preview new or changed watched sources ready for duplicate-safe source-intelligence materialization.", "responses": { "200": { "description": "prelistproof.source_watchlist_worker.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.source_watchlist_worker.v1" } } } } } } } }, "post": { "tags": [ "Source Watchlist", "Agent Scheduler" ], "summary": "Route changed watched sources through the connector inbox, append watchlist events, and materialize source intelligence without changing live rules or making certification, legal, insurance, financing, or approval-guarantee claims.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "mode": "simulate", "limit": 20, "force": false } } } }, "responses": { "201": { "description": "prelistproof.source_watchlist_worker_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.source_watchlist_worker_result.v1" } } } } } }, "202": { "description": "no_new_or_changed_watch_sources", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "no_new_or_changed_watch_sources" } } } } } } } } }, "/api/channel-autopilot": { "get": { "tags": [ "Channel Autopilot", "Event Bus", "Connector Dispatch" ], "summary": "Read moat-backed channel play candidates, append-only channel events, worker state, and fixed-fee/liability boundaries.", "responses": { "200": { "description": "prelistproof.channel_autopilot_console.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.channel_autopilot_console.v1" } } } } } } } } }, "/api/channel-autopilot/worker": { "get": { "tags": [ "Channel Autopilot", "Agent Scheduler" ], "summary": "Preview weekly partner distribution plays derived from proof, outcome, integration, source, and expansion ledgers.", "responses": { "200": { "description": "prelistproof.channel_autopilot_worker.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.channel_autopilot_worker.v1" } } } } } } } }, "post": { "tags": [ "Channel Autopilot", "Agent Scheduler", "Connector Dispatch" ], "summary": "Record duplicate-safe channel play events and connector-ready outbox rows without certification, legal, insurance, lending, or approval-guarantee claims.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "mode": "simulate", "limit": 20 } } } }, "responses": { "201": { "description": "prelistproof.channel_autopilot_worker_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.channel_autopilot_worker_result.v1" } } } } } } } } }, "/api/channel-autopilot/responses": { "get": { "tags": [ "Channel Autopilot", "Event Bus" ], "summary": "Read append-only channel response events, response graph scoring, and pending inferred response jobs.", "responses": { "200": { "description": "prelistproof.channel_response_console.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.channel_response_console.v1" } } } } } } } }, "post": { "tags": [ "Channel Autopilot", "Connector Dispatch" ], "summary": "Capture a partner response linked to a channel event, outbox event, or play key for future channel ranking.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "channel_event_id": "ch_...", "response": "interested", "response_source": "crm_connector", "source_id": "crm_thread_123", "notes": "Partner asked for API docs." } } } }, "responses": { "201": { "description": "prelistproof.channel_response_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.channel_response_result.v1" } } } } } }, "400": { "description": "invalid_channel_response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "invalid_channel_response" } } } } } } } } }, "/api/channel-autopilot/responses/worker": { "get": { "tags": [ "Channel Autopilot", "Agent Scheduler" ], "summary": "Preview inferred channel response jobs from downstream integration activation and elapsed-delivery evidence.", "responses": { "200": { "description": "prelistproof.channel_response_worker.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.channel_response_worker.v1" } } } } } } } }, "post": { "tags": [ "Channel Autopilot", "Agent Scheduler" ], "summary": "Infer duplicate-safe response events from downstream activation ledgers without inventing external replies.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "mode": "simulate", "limit": 50 } } } }, "responses": { "201": { "description": "prelistproof.channel_response_worker_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.channel_response_worker_result.v1" } } } } } } } } }, "/api/customer-success": { "get": { "tags": [ "Customer Success", "Connectors" ], "summary": "Read append-only customer success triage events, current safe-reply jobs, and liability boundaries.", "responses": { "200": { "description": "prelistproof.customer_success_console.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.customer_success_console.v1" } } } } } } } }, "post": { "tags": [ "Customer Success", "Connectors" ], "summary": "Record a support, billing, status, API, refund, or dispute case and classify it for safe automation or human review.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "from": "seller@example.com", "subject": "Where is my PreListProof report and receipt?", "body": "Can you send the status and receipt for my fixed-fee order?", "source_type": "customer_success" } } } }, "responses": { "201": { "description": "prelistproof.customer_success_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.customer_success_result.v1" } } } } } }, "400": { "description": "invalid_customer_success_case", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "invalid_customer_success_case" } } } } } } } } }, "/api/customer-success/worker": { "get": { "tags": [ "Customer Success" ], "summary": "Preview safe customer-success replies that can be queued to the connector outbox.", "responses": { "200": { "description": "prelistproof.customer_success_worker.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.customer_success_worker.v1" } } } } } } } }, "post": { "tags": [ "Customer Success" ], "summary": "Queue duplicate-safe customer-success reply rows without issuing refunds, handling disputes, or making certification, legal, insurance, or approval-guarantee claims.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "mode": "simulate", "limit": 20 } } } }, "responses": { "201": { "description": "prelistproof.customer_success_worker_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.customer_success_worker_result.v1" } } } } } } } } }, "/api/monitor": { "get": { "tags": [ "Portfolio Monitoring" ], "summary": "Read recurring monitor jobs for saved public records, outcomes, hard blockers, and rule-pattern matches.", "responses": { "200": { "description": "prelistproof.portfolio_monitor_console.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.portfolio_monitor_console.v1" } } } } } } } } }, "/api/monitor/worker": { "get": { "tags": [ "Portfolio Monitoring" ], "summary": "Preview the recurring portfolio monitor worker queue.", "responses": { "200": { "description": "prelistproof.portfolio_monitor_console.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.portfolio_monitor_console.v1" } } } } } } } }, "post": { "tags": [ "Portfolio Monitoring" ], "summary": "Run a recurring monitor sweep and write monitor events plus connector-ready outbox notices when contact exists.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "mode": "simulate", "limit": 50 } } } }, "responses": { "201": { "description": "prelistproof.portfolio_monitor_worker_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.portfolio_monitor_worker_result.v1" } } } } } } } } }, "/api/webhooks/events": { "get": { "tags": [ "Event Bus" ], "summary": "Read the replayable event stream for reports, outcomes, monitor events, rule audits, connector routes, and platform usage.", "responses": { "200": { "description": "prelistproof.event_bus_console.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.event_bus_console.v1" } } } } } } } } }, "/api/webhooks/subscriptions": { "get": { "tags": [ "Event Bus" ], "summary": "List webhook/event subscriptions without exposing signing secrets.", "responses": { "200": { "description": "prelistproof.webhook_subscription_console.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.webhook_subscription_console.v1" } } } } } } } }, "post": { "tags": [ "Event Bus" ], "summary": "Create a replay/delivery subscription and return a one-time signing secret.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "company": "Agentic Commerce Co", "email": "platform@example.com", "endpoint_url": "https://example.test/prelistproof/webhook", "event_types": [ "verification.report.created", "marketplace.outcome.recorded", "learning.loop.recorded", "rule_pack.release_candidate.recorded", "portfolio.monitor.event", "growth.source.recorded", "source.watchlist.recorded", "source.intelligence.recorded" ] } } } }, "responses": { "201": { "description": "prelistproof.webhook_subscription_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.webhook_subscription_result.v1" } } } } } }, "400": { "description": "invalid_webhook_subscription", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "invalid_webhook_subscription" } } } } } } } } }, "/api/webhooks/worker": { "get": { "tags": [ "Event Bus" ], "summary": "Preview pending subscription delivery jobs.", "responses": { "200": { "description": "prelistproof.webhook_worker.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.webhook_worker.v1" } } } } } } } }, "post": { "tags": [ "Event Bus" ], "summary": "Run the event delivery worker in simulate or connector handoff mode.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "mode": "simulate", "limit": 100 } } } }, "responses": { "201": { "description": "prelistproof.webhook_worker_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.webhook_worker_result.v1" } } } } } } } } }, "/api/dispatch/queue": { "get": { "tags": [ "Connector Dispatch" ], "summary": "Read connector-owned email and webhook delivery jobs with lease/ack overlay state.", "parameters": [ { "name": "limit", "in": "query", "schema": { "type": "integer" }, "required": false }, { "name": "include_simulated", "in": "query", "schema": { "type": "boolean" }, "required": false } ], "responses": { "200": { "description": "prelistproof.dispatch_console.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.dispatch_console.v1" } } } } } } } } }, "/api/dispatch/leases": { "get": { "tags": [ "Connector Dispatch" ], "summary": "Read recent dispatch leases and acknowledgements.", "responses": { "200": { "description": "prelistproof.dispatch_lease_console.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.dispatch_lease_console.v1" } } } } } } } } }, "/api/dispatch/lease": { "post": { "tags": [ "Connector Dispatch" ], "summary": "Claim connector delivery jobs for a bounded lease interval.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "connector": "gmail_or_webhook_worker", "channels": [ "email", "webhook" ], "limit": 10, "lease_seconds": 300, "include_simulated": false } } } }, "responses": { "201": { "description": "prelistproof.dispatch_lease_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.dispatch_lease_result.v1" } } } } } }, "400": { "description": "invalid_dispatch_lease", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "invalid_dispatch_lease" } } } } } } } } }, "/api/dispatch/ack": { "post": { "tags": [ "Connector Dispatch" ], "summary": "Acknowledge a connector delivery job as sent, delivered, failed, skipped, or simulated.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "job_id": "dq_...", "lease_id": "dlease_...", "connector": "gmail_or_webhook_worker", "status": "sent", "provider_message_id": "msg_...", "retryable": true } } } }, "responses": { "201": { "description": "prelistproof.dispatch_ack_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.dispatch_ack_result.v1" } } } } } }, "400": { "description": "invalid_dispatch_ack", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "invalid_dispatch_ack" } } } } } } } } }, "/api/dispatch/worker": { "get": { "tags": [ "Connector Dispatch" ], "summary": "Preview safe connector delivery rows that can be leased and locally acknowledged by the scheduled dispatch worker.", "responses": { "200": { "description": "prelistproof.dispatch_worker.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.dispatch_worker.v1" } } } } } } } }, "post": { "tags": [ "Connector Dispatch" ], "summary": "Lease safe connector delivery rows and append simulated delivery acknowledgements without external transmission.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "mode": "simulate", "limit": 100, "channels": [ "email", "webhook" ] } } } }, "responses": { "201": { "description": "prelistproof.dispatch_worker_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.dispatch_worker_result.v1" } } } } } } } } }, "/api/claim-guard": { "get": { "tags": [ "Claim Guard" ], "summary": "Read outbound/public claim-safety findings across outbox, webhook, public, terms, OpenAPI, and integration surfaces.", "responses": { "200": { "description": "prelistproof.claim_guard_console.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.claim_guard_console.v1" } } } } } } } }, "post": { "tags": [ "Claim Guard" ], "summary": "Run an ad hoc claim-safety check on supplied copy.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "text": "PreListProof is decision support only. It is not certification, legal advice, insurance, or an approval guarantee.", "source_type": "ad_hoc", "label": "Draft seller reply" } } } }, "responses": { "201": { "description": "prelistproof.claim_guard_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.claim_guard_result.v1" } } } } } } } } }, "/api/claim-guard/worker": { "get": { "tags": [ "Claim Guard" ], "summary": "Preview unsafe claim findings that need audit ledger capture.", "responses": { "200": { "description": "prelistproof.claim_guard_worker.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.claim_guard_worker.v1" } } } } } } } }, "post": { "tags": [ "Claim Guard" ], "summary": "Run the claim guard worker and append a duplicate-safe audit event when unsafe findings exist or record_pass is true.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "limit": 200, "record_pass": false } } } }, "responses": { "201": { "description": "prelistproof.claim_guard_worker_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.claim_guard_worker_result.v1" } } } } } } } } }, "/api/learning-loop": { "get": { "tags": [ "Learning Loop" ], "summary": "Read the versioned moat loop: stored outcomes, trust graph retrieval, advisory rule promotion, and safe rule-pack recommendations.", "responses": { "200": { "description": "prelistproof.learning_loop_console.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.learning_loop_console.v1" } } } } } } } } }, "/api/learning-loop/worker": { "get": { "tags": [ "Learning Loop" ], "summary": "Preview whether stored outcomes need to be materialized into a learning-loop audit event.", "responses": { "200": { "description": "prelistproof.learning_loop_worker.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.learning_loop_worker.v1" } } } } } } } }, "post": { "tags": [ "Learning Loop" ], "summary": "Run the duplicate-safe learning loop without editing rule packs or making certification, legal, insurance, or approval-guarantee claims.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "mode": "simulate", "limit": 50 } } } }, "responses": { "201": { "description": "prelistproof.learning_loop_worker_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.learning_loop_worker_result.v1" } } } } } } } } }, "/api/calibration": { "get": { "tags": [ "Outcome Calibration", "Learning Loop" ], "summary": "Read derived outcome calibration that compares preflight posture to accepted, fixed, rejected, and still-blocked marketplace outcomes.", "responses": { "200": { "description": "prelistproof.outcome_calibration.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.outcome_calibration.v1" } } } } } } } } }, "/api/health": { "get": { "tags": [ "Autonomy Health" ], "summary": "Run a read-only autonomy self-audit across contracts, ledgers, privacy boundaries, fixed-fee constraints, dispatch, and exception load.", "responses": { "200": { "description": "prelistproof.autonomy_health.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.autonomy_health.v1" } } } } } } } } }, "/api/health/worker": { "get": { "tags": [ "Autonomy Health" ], "summary": "Preview the current autonomy health state.", "responses": { "200": { "description": "prelistproof.autonomy_health.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.autonomy_health.v1" } } } } } } } }, "post": { "tags": [ "Autonomy Health" ], "summary": "Run the autonomy health worker and append a health ledger event.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "limit": 100 } } } }, "responses": { "201": { "description": "prelistproof.health_worker_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.health_worker_result.v1" } } } } } } } } }, "/api/launch": { "get": { "tags": [ "Autonomy Health", "Company OS" ], "summary": "Read the production go-live readiness gate, including external setup blockers for domain, payments, delivery connectors, storage, secrets, alerts, and launch-safe liability boundaries.", "responses": { "200": { "description": "prelistproof.launch_readiness.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.launch_readiness.v1" } } } } } } } } }, "/api/deploy": { "get": { "tags": [ "Autonomy Health", "Company OS" ], "summary": "Read the production deployment pack, artifact hashes, docker/compose/preflight checks, and fixed-fee launch boundary.", "responses": { "200": { "description": "prelistproof.deploy_pack.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.deploy_pack.v1" } } } } } } } } }, "/api/deploy/env": { "get": { "tags": [ "Autonomy Health", "Company OS" ], "summary": "Read the secret-safe production environment readiness map for domain, payments, delivery, storage, secrets, and alerting without exposing values.", "responses": { "200": { "description": "prelistproof.production_env_console.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.production_env_console.v1" } } } } } } } } }, "/api/agents/scheduler": { "get": { "tags": [ "Agent Scheduler" ], "summary": "Preview the no-touch scheduler across growth, activation, fulfillment, and follow-up jobs.", "responses": { "200": { "description": "prelistproof.agent_scheduler.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.agent_scheduler.v1" } } } } } } } }, "post": { "tags": [ "Agent Scheduler" ], "summary": "Run the no-touch scheduler tick in phase order.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "mode": "simulate", "limit": 20, "minimum_age_hours": 72 } } } }, "responses": { "201": { "description": "prelistproof.agent_scheduler_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.agent_scheduler_result.v1" } } } } } } } } }, "/api/growth/leads": { "get": { "tags": [ "Growth" ], "summary": "Read growth leads, qualification stats, and pending outreach jobs.", "responses": { "200": { "description": "prelistproof.growth_console.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.growth_console.v1" } } } } } } } }, "post": { "tags": [ "Growth" ], "summary": "Post a public demand signal for automatic fixed-fee lead qualification.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "source_type": "forum", "contact_email": "seller@example.com", "company": "Signal Seller Co", "marketplace": "amazon_us", "category": "electronics", "source_text": "Amazon rejected our Bluetooth speaker because FCC ID is missing from label photos." } } } }, "responses": { "201": { "description": "prelistproof.growth_lead.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.growth_lead.v1" } } } } } }, "400": { "description": "invalid_growth_lead", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "invalid_growth_lead" } } } } } } } } }, "/api/growth/sources": { "get": { "tags": [ "Growth" ], "summary": "Read append-only public source acquisition records, stats, and pending conversion jobs.", "responses": { "200": { "description": "prelistproof.growth_source_console.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.growth_source_console.v1" } } } } } } } }, "post": { "tags": [ "Growth" ], "summary": "Post a public search, RSS, forum, policy, marketplace, partner, or manual source signal for automatic lead conversion.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "source_type": "search_result", "source_url": "https://sellercentral.amazon.com/help", "marketplace": "amazon_us", "category": "electronics", "source_text": "Public seller signal: listing blocked because FCC ID is missing from label photos and the lab report model does not match the listing model." } } } }, "responses": { "201": { "description": "prelistproof.growth_source.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.growth_source.v1" } } } } } }, "400": { "description": "invalid_growth_source", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "invalid_growth_source" } } } } } } } } }, "/api/growth/sources/worker": { "get": { "tags": [ "Growth", "Agent Scheduler" ], "summary": "Preview source acquisition jobs that will convert public source signals into growth leads.", "responses": { "200": { "description": "prelistproof.growth_source_worker.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.growth_source_worker.v1" } } } } } } } }, "post": { "tags": [ "Growth", "Agent Scheduler" ], "summary": "Convert public source acquisition records into fixed-fee growth leads without sending external outreach.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "mode": "simulate", "limit": 20 } } } }, "responses": { "201": { "description": "prelistproof.growth_source_worker_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.growth_source_worker_result.v1" } } } } } } } } }, "/api/growth/worker": { "get": { "tags": [ "Growth" ], "summary": "Preview qualified outreach jobs from growth leads.", "responses": { "200": { "description": "prelistproof.growth_worker.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.growth_worker.v1" } } } } } } } }, "post": { "tags": [ "Growth" ], "summary": "Queue duplicate-safe fixed-fee outreach events for qualified leads.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "mode": "simulate", "limit": 20 } } } }, "responses": { "201": { "description": "prelistproof.growth_worker_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.growth_worker_result.v1" } } } } } } } } }, "/api/catalog": { "get": { "tags": [ "Public Records" ], "summary": "List public verification records.", "security": [ {} ], "responses": { "200": { "description": "prelistproof.public_catalog.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.public_catalog.v1" } } } } } } } } }, "/api/transparency-log": { "get": { "tags": [ "Transparency", "Public Records" ], "summary": "Read the current Merkle checkpoint over public and private-hash ledgers.", "security": [ {} ], "parameters": [ { "name": "limit", "in": "query", "schema": { "type": "integer" }, "required": false } ], "responses": { "200": { "description": "prelistproof.transparency_log.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.transparency_log.v1" } } } } } } } } }, "/api/transparency-proof": { "get": { "tags": [ "Transparency", "Public Records" ], "summary": "Read a Merkle inclusion proof for a report, outcome, payment event, or ledger subject ID.", "security": [ {} ], "parameters": [ { "name": "id", "in": "query", "schema": { "type": "string" }, "required": true } ], "responses": { "200": { "description": "prelistproof.transparency_proof.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.transparency_proof.v1" } } } } } }, "404": { "description": "transparency_leaf_not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "transparency_leaf_not_found" } } } } } } } } }, "/api/trust-graph": { "get": { "tags": [ "Public Records" ], "summary": "Read outcome-backed acceptance signals.", "security": [ {} ], "responses": { "200": { "description": "prelistproof.trust_graph.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.trust_graph.v1" } } } } } } } } }, "/api/registry/refresh": { "get": { "tags": [ "Public Records" ], "summary": "Preview registry evidence refresh jobs and recent append-only refresh events.", "responses": { "200": { "description": "prelistproof.registry_refresh_console.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.registry_refresh_console.v1" } } } } } } } } }, "/api/registry/refresh/worker": { "get": { "tags": [ "Public Records" ], "summary": "Preview registry evidence refresh jobs and recent append-only refresh events.", "responses": { "200": { "description": "prelistproof.registry_refresh_console.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.registry_refresh_console.v1" } } } } } } } }, "post": { "tags": [ "Public Records" ], "summary": "Record registry evidence refreshes in the append-only evidence ledger.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "mode": "simulate", "limit": 20, "stale_days": 30 } } } }, "responses": { "201": { "description": "prelistproof.registry_refresh_worker_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.registry_refresh_worker_result.v1" } } } } } } } } }, "/api/patterns": { "get": { "tags": [ "Public Records", "Rule Mining" ], "summary": "Read automatically mined marketplace rejection patterns.", "security": [ {} ], "responses": { "200": { "description": "prelistproof.rejection_patterns.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.rejection_patterns.v1" } } } } } } } } }, "/api/rules/candidates": { "get": { "tags": [ "Rule Mining" ], "summary": "Read private candidate-rule queue for research agents.", "responses": { "200": { "description": "prelistproof.rule_candidate_queue.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.rule_candidate_queue.v1" } } } } } } } }, "post": { "tags": [ "Rule Mining" ], "summary": "Post policy, support, rejection, forum, or outcome text for automatic rule-candidate mining.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "source_type": "rejection", "marketplace": "amazon", "category": "electronics", "source_text": "FCC ID missing from label photo and model on lab report does not match listing model." } } } }, "responses": { "201": { "description": "prelistproof.rule_candidate.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.rule_candidate.v1" } } } } } }, "400": { "description": "invalid_rule_candidate", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "invalid_rule_candidate" } } } } } } } } }, "/api/rules/promotions": { "get": { "tags": [ "Rule Mining" ], "summary": "Read private outcome-backed rule-promotion decisions for the rules agent.", "responses": { "200": { "description": "prelistproof.rule_promotion_console.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.rule_promotion_console.v1" } } } } } } } }, "post": { "tags": [ "Rule Mining" ], "summary": "Run an advisory rule-promotion audit without editing rule packs or making compliance claims.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "mode": "simulate", "limit": 50 } } } }, "responses": { "201": { "description": "prelistproof.rule_promotion_audit_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.rule_promotion_audit_result.v1" } } } } } } } } }, "/api/rule-packs/recommendations": { "get": { "tags": [ "Rule Packs" ], "summary": "Read versioned, hash-addressed safe rule-pack recommendations derived from learning-loop and promotion evidence.", "responses": { "200": { "description": "prelistproof.rule_pack_recommendation_console.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.rule_pack_recommendation_console.v1" } } } } } } } } }, "/api/rule-packs/recommendations/worker": { "get": { "tags": [ "Rule Packs" ], "summary": "Preview whether the latest learning event needs a materialized rule-pack recommendation snapshot.", "responses": { "200": { "description": "prelistproof.rule_pack_recommendation_worker.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.rule_pack_recommendation_worker.v1" } } } } } } } }, "post": { "tags": [ "Rule Packs" ], "summary": "Append a duplicate-safe recommendation snapshot without changing live rules or making certification, legal, insurance, or approval-guarantee claims.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "mode": "simulate" } } } }, "responses": { "201": { "description": "prelistproof.rule_pack_recommendation_worker_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.rule_pack_recommendation_worker_result.v1" } } } } } } } } }, "/api/rule-packs/releases": { "get": { "tags": [ "Rule Pack Releases" ], "summary": "Read gated, append-only rule-pack release candidates derived from advisory recommendations.", "responses": { "200": { "description": "prelistproof.rule_pack_release_console.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.rule_pack_release_console.v1" } } } } } } } } }, "/api/rule-packs/releases/worker": { "get": { "tags": [ "Rule Pack Releases" ], "summary": "Preview whether the latest recommendation snapshot needs a release-candidate gate event.", "responses": { "200": { "description": "prelistproof.rule_pack_release_worker.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.rule_pack_release_worker.v1" } } } } } } } }, "post": { "tags": [ "Rule Pack Releases" ], "summary": "Append a duplicate-safe release-candidate gate without changing live rules or making certification, legal, insurance, or approval-guarantee claims.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "mode": "simulate" } } } }, "responses": { "201": { "description": "prelistproof.rule_pack_release_worker_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.rule_pack_release_worker_result.v1" } } } } } } } } }, "/api/verify": { "get": { "tags": [ "Public Records" ], "summary": "Read a public verification record by report ID.", "security": [ {} ], "parameters": [ { "name": "id", "in": "query", "schema": { "type": "string" }, "required": true } ], "responses": { "200": { "description": "prelistproof.public_verification.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.public_verification.v1" } } } } } }, "404": { "description": "report_not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "report_not_found" } } } } } } } } }, "/api/badge": { "get": { "tags": [ "Embeds", "Public Records" ], "summary": "Read an embeddable trust badge by report ID.", "security": [ {} ], "parameters": [ { "name": "id", "in": "query", "schema": { "type": "string" }, "required": true } ], "responses": { "200": { "description": "prelistproof.trust_badge.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.trust_badge.v1" } } } } } }, "404": { "description": "report_not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "report_not_found" } } } } } } } } }, "/api/intake": { "post": { "tags": [ "Autopilot" ], "summary": "Start automatic fixed-fee seller intake.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "email": "seller@example.com", "company": "Seller Co", "marketplace": "amazon_us", "category": "electronics", "issue_type": "preflight", "product_title": "Bluetooth Speaker", "model": "BT-100", "consent_to_contact": true } } } }, "responses": { "201": { "description": "prelistproof.intake_response.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.intake_response.v1" } } } } } }, "400": { "description": "invalid_request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "invalid_request" } } } } } } } } }, "/api/exceptions": { "get": { "tags": [ "Autopilot" ], "summary": "Read the exception-only operations queue separating human review from agent actions and waiting states.", "responses": { "200": { "description": "prelistproof.exception_queue.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.exception_queue.v1" } } } } } } } } }, "/api/packet": { "post": { "tags": [ "Autopilot" ], "summary": "Submit packet text for automatic backend preflight.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "request_id": "rq_...", "packet_text": "Marketplace rejection text, FCC ID, model bridge, label text, lab report scope...", "allow_public_record": true } } } }, "responses": { "201": { "description": "prelistproof.packet_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.packet_result.v1" } } } } } }, "400": { "description": "packet_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "packet_error" } } } } } } } } }, "/api/outcomes": { "get": { "tags": [ "Learning Loop", "Autopilot", "Public Records" ], "summary": "Read append-only accepted, rejected, fixed, and still-blocked marketplace outcomes linked back to reports and packets.", "responses": { "200": { "description": "prelistproof.outcome_ledger.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.outcome_ledger.v1" } } } } } } } }, "post": { "tags": [ "Learning Loop", "Autopilot" ], "summary": "Record a marketplace outcome in the append-only outcome ledger so the trust graph, calibration layer, and learning loop can update.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "report_id": "pl_...", "request_id": "rq_...", "outcome": "accepted", "source": "marketplace_message" } } } }, "responses": { "201": { "description": "prelistproof.marketplace_outcome.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.marketplace_outcome.v1" } } } } } }, "400": { "description": "invalid_outcome", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "invalid_outcome" } } } } } } } } }, "/api/outcome/listener": { "get": { "tags": [ "Autopilot" ], "summary": "Read listener event queue.", "responses": { "200": { "description": "prelistproof.outcome_listener.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.outcome_listener.v1" } } } } } } } }, "post": { "tags": [ "Autopilot" ], "summary": "Parse marketplace message text and record clear outcomes.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "connector": "gmail_or_marketplace_webhook", "subject": "Compliance documents accepted", "body": "Your submission has been approved. PreListProof report pl_...", "report_id": "pl_..." } } } }, "responses": { "201": { "description": "outcome_recorded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "outcome_recorded" } } } } } }, "202": { "description": "needs_review", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "needs_review" } } } } } } } } }, "/api/outcome/listener/worker": { "get": { "tags": [ "Autopilot" ], "summary": "Preview append-only listener triage jobs for non-outcome acknowledgements.", "responses": { "200": { "description": "prelistproof.outcome_listener_worker.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.outcome_listener_worker.v1" } } } } } } } }, "post": { "tags": [ "Autopilot" ], "summary": "Append duplicate-safe listener triage rows without recording marketplace outcomes unless a report and clear outcome exist.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "limit": 100 } } } }, "responses": { "201": { "description": "prelistproof.outcome_listener_worker_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.outcome_listener_worker_result.v1" } } } } } } } } }, "/api/autopilot/worker": { "get": { "tags": [ "Autopilot" ], "summary": "Preview pending fulfillment worker jobs.", "responses": { "200": { "description": "prelistproof.autopilot_worker.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.autopilot_worker.v1" } } } } } } } }, "post": { "tags": [ "Autopilot" ], "summary": "Run a local/scheduled worker tick.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "example": { "mode": "simulate", "limit": 20 } } } }, "responses": { "201": { "description": "prelistproof.autopilot_worker_result.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.autopilot_worker_result.v1" } } } } } } } } }, "/api/outbox": { "get": { "tags": [ "Autopilot" ], "summary": "Read connector-ready outbox events.", "responses": { "200": { "description": "prelistproof.connector_outbox.v1", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonObject" }, "examples": { "default": { "value": { "schema_version": "prelistproof.connector_outbox.v1" } } } } } } } } } }, "components": { "securitySchemes": { "PreListProofApiKey": { "type": "apiKey", "in": "header", "name": "x-prelistproof-api-key", "description": "Create at /platform. PreListProof stores only the key hash and prefix. The prototype also accepts x-shelfclear-api-key for legacy local ledgers." } }, "schemas": { "JsonObject": { "type": "object", "additionalProperties": true } } }, "x-prelistproof-boundary": { "fixed_fee_only": true, "excluded": [ "lending", "interest", "insurance", "approval guarantees", "legal certification" ], "public_records_hide_raw_packet_text": true } }