{"openapi":"3.0.3","info":{"title":"AgentReeve API","version":"5.2.1","contact":{"email":"hello@agentreeve.com","url":"https://agentreeve.com"},"description":"Semantic API discovery and evidence-backed routing for AI agents. Public discovery uses observed evidence rather than directory price claims. For a paid-provider winner, AgentReeve charges only its fixed winner-independent routing fee and returns a buyer-direct provider handoff; the buyer then pays the seller directly. Free-provider routes remain $0 and may execute through AgentReeve."},"servers":[{"url":"https://agentreeve.com"}],"x-agentreeve-payment-model":{"seller_payment":"buyer_direct","seller_payment_handled_by_agentreeve":false,"route_fee_collected_by_agentreeve":true},"components":{"securitySchemes":{"x402":{"type":"http","scheme":"x402","description":"x402 v2 exact USDC payment on Base."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true},"RouteRequest":{"type":"object","additionalProperties":true,"properties":{"need":{"type":"string","maxLength":4000,"description":"Natural-language executable job. Optional when capability_id, category, or url is supplied."},"capability_id":{"type":"string","description":"Exact live capability ID from GET /api/capabilities."},"category":{"type":"string","description":"Category board. With a natural-language job this is only a hint unless category_lock=true."},"category_hint":{"type":"string"},"category_lock":{"type":"boolean"},"url":{"type":"string","format":"uri","description":"Route only to this already-indexed endpoint."},"payload":{"description":"Provider request payload. Known schema compatibility is enforced before free execution or a paid-provider direct handoff."},"dry_run":{"type":"boolean","description":"Preview only. Never calls a provider and never charges."},"prefer":{"type":"string","enum":["value","best","cheapest","fastest","proven","custom"]},"weights":{"type":"object","properties":{"relevance":{"type":"number","minimum":0},"craft":{"type":"number","minimum":0},"price":{"type":"number","minimum":0},"speed":{"type":"number","minimum":0},"traction":{"type":"number","minimum":0}},"additionalProperties":false},"max_price_usd":{"type":"number","minimum":0,"description":"Maximum seller price, excluding the AgentReeve routing fee."},"min_price_usd":{"type":"number","minimum":0},"max_total_usd":{"type":"number","minimum":0,"description":"Maximum expected buyer outlay across the two direct legs: observed seller price + fixed AgentReeve fee. AgentReeve collects only its fee."},"min_craft":{"type":"number","minimum":0,"maximum":100},"max_latency_ms":{"type":"number","minimum":0,"maximum":600000},"min_uptime":{"type":"number","minimum":0,"maximum":100},"require_proven":{"type":"boolean","description":"Require observed on-chain payment activity to the advertised payTo. This is not proof of an API purchase."},"require_negotiable":{"type":"boolean"},"free_only":{"type":"boolean"},"only_domains":{"type":"array","maxItems":50,"items":{"type":"string"}},"exclude_domains":{"type":"array","maxItems":50,"items":{"type":"string"}},"idempotent":{"type":"boolean","description":"Declare that retry/failover after an ambiguous failure is safe."},"allow_ambiguous_failover":{"type":"boolean","deprecated":true,"description":"Legacy alias for idempotent."},"idempotency_key":{"type":"string","maxLength":512},"timeout_ms":{"type":"number","minimum":1000,"maximum":60000},"negotiation_timeout_ms":{"type":"number","minimum":800,"maximum":6000},"headers":{"type":"object","additionalProperties":{"type":"string"},"description":"Additional headers are sanitized and forwarded only for free-provider execution. For paid-provider handoffs, keep credentials locally and merge them into the direct seller request yourself; AgentReeve never receives seller payment signatures."},"route_nonce":{"type":"string","description":"Nonce from a prior paid route quote. Retry with the identical policy/payload."},"negotiate":{"type":"object","additionalProperties":false,"properties":{"enabled":{"type":"boolean"},"max_rounds":{"type":"integer","minimum":1,"maximum":3},"target_ratio":{"type":"number","minimum":0.1,"maximum":1},"on_reject":{"type":"string","enum":["accept_list","skip","require_target","best_quote"]}}},"provider":{"type":"object","additionalProperties":false,"properties":{"order":{"type":"array","maxItems":50,"items":{"type":"string"}},"only":{"type":"array","maxItems":50,"items":{"type":"string"}},"ignore":{"type":"array","maxItems":50,"items":{"type":"string"}},"allow_fallbacks":{"type":"boolean","default":true},"sort":{"type":"string","enum":["price","latency","quality","traction","relevance","value"]},"max_price_usd":{"type":"number","minimum":0},"max_price":{"type":"object","properties":{"request":{"type":"number","minimum":0}}},"preferred_max_latency_ms":{"type":"number","minimum":0},"require_parameters":{"type":"boolean","readOnly":true,"description":"Always true. Payload/schema safety is not caller-disableable."}}}}}}},"paths":{"/healthz":{"get":{"summary":"Process liveness and diagnostics. HTTP 200 means the process can answer; it does not imply production readiness.","security":[],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"404":{"description":"Requested indexed resource was not found","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded"},"503":{"description":"Required production dependency is unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}}}}},"/readyz":{"get":{"summary":"Production readiness. Returns HTTP 503 while draining or when a required database, worker or local payment layer is unavailable.","security":[],"responses":{"200":{"description":"Ready"},"503":{"description":"Required production dependency is unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}}}}},"/api/local-ai/health":{"get":{"summary":"Optional local control-plane model health. This model has no payment authority and never changes neutral route ranking.","security":[],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"404":{"description":"Requested indexed resource was not found","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded"},"503":{"description":"Required production dependency is unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}}}}},"/api/orchestrate/capabilities":{"get":{"summary":"List the 13 Innernet-native primitives available to the opt-in orchestration layer. /api/route remains provider-neutral.","security":[],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"404":{"description":"Requested indexed resource was not found","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded"},"503":{"description":"Required production dependency is unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}}}}},"/api/orchestrate":{"post":{"summary":"Authenticated local-Qwen control-plane plan: local vs Innernet vs neutral marketplace. Innernet results are buyer-direct x402 handoffs; no provider payment is made by AgentReeve.","security":[],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"404":{"description":"Requested indexed resource was not found","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded"},"503":{"description":"Required production dependency is unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["need"],"properties":{"need":{"type":"string","maxLength":4000},"payload":{"type":"object"},"max_price_usd":{"type":"number","minimum":0},"max_total_usd":{"type":"number","minimum":0},"provider":{"type":"object"}},"additionalProperties":true}}}}}},"/api/orchestrate/rank":{"post":{"summary":"Authenticated provider-blind advisory relevance ranker. Output is never applied to the neutral /api/route money path.","security":[],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"404":{"description":"Requested indexed resource was not found","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded"},"503":{"description":"Required production dependency is unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}}}}},"/api/orchestrate/critic":{"post":{"summary":"Authenticated advisory response critic. Output never changes evidence scores or payment state.","security":[],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"404":{"description":"Requested indexed resource was not found","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded"},"503":{"description":"Required production dependency is unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}}}}},"/api/route":{"post":{"summary":"Preview or route using fresh evidence. A paid winner returns an x402 quote for only the fixed $0.003 AgentReeve fee; after fee settlement the response contains a buyer-direct provider handoff. A free winner costs $0 and may execute through AgentReeve.","security":[],"x-payment-info":{"protocols":["x402"],"mode":"conditional","paid_winner_agentreeve_fee_usd":0.003,"free_winner_total_usd":0,"seller_price":"observed x402 quote, optionally reduced through side-effect-free quote-only negotiation","seller_payment_mode":"buyer_direct","seller_payment_collected_by_agentreeve":false},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"need":{"type":"string","maxLength":4000,"description":"Natural-language executable job. Optional when capability_id, category, or url is supplied."},"capability_id":{"type":"string","description":"Exact live capability ID from GET /api/capabilities."},"category":{"type":"string","description":"Category board. With a natural-language job this is only a hint unless category_lock=true."},"category_hint":{"type":"string"},"category_lock":{"type":"boolean"},"url":{"type":"string","format":"uri","description":"Route only to this already-indexed endpoint."},"payload":{"description":"Provider request payload. Known schema compatibility is enforced before free execution or a paid-provider direct handoff."},"dry_run":{"type":"boolean","description":"Preview only. Never calls a provider and never charges."},"prefer":{"type":"string","enum":["value","best","cheapest","fastest","proven","custom"]},"weights":{"type":"object","properties":{"relevance":{"type":"number","minimum":0},"craft":{"type":"number","minimum":0},"price":{"type":"number","minimum":0},"speed":{"type":"number","minimum":0},"traction":{"type":"number","minimum":0}},"additionalProperties":false},"max_price_usd":{"type":"number","minimum":0,"description":"Maximum seller price, excluding the AgentReeve routing fee."},"min_price_usd":{"type":"number","minimum":0},"max_total_usd":{"type":"number","minimum":0,"description":"Maximum expected buyer outlay across the two direct legs: observed seller price + fixed AgentReeve fee. AgentReeve collects only its fee."},"min_craft":{"type":"number","minimum":0,"maximum":100},"max_latency_ms":{"type":"number","minimum":0,"maximum":600000},"min_uptime":{"type":"number","minimum":0,"maximum":100},"require_proven":{"type":"boolean","description":"Require observed on-chain payment activity to the advertised payTo. This is not proof of an API purchase."},"require_negotiable":{"type":"boolean"},"free_only":{"type":"boolean"},"only_domains":{"type":"array","maxItems":50,"items":{"type":"string"}},"exclude_domains":{"type":"array","maxItems":50,"items":{"type":"string"}},"idempotent":{"type":"boolean","description":"Declare that retry/failover after an ambiguous failure is safe."},"allow_ambiguous_failover":{"type":"boolean","deprecated":true,"description":"Legacy alias for idempotent."},"idempotency_key":{"type":"string","maxLength":512},"timeout_ms":{"type":"number","minimum":1000,"maximum":60000},"negotiation_timeout_ms":{"type":"number","minimum":800,"maximum":6000},"headers":{"type":"object","additionalProperties":{"type":"string"},"description":"Additional headers are sanitized and forwarded only for free-provider execution. For paid-provider handoffs, keep credentials locally and merge them into the direct seller request yourself; AgentReeve never receives seller payment signatures."},"route_nonce":{"type":"string","description":"Nonce from a prior paid route quote. Retry with the identical policy/payload."},"negotiate":{"type":"object","additionalProperties":false,"properties":{"enabled":{"type":"boolean"},"max_rounds":{"type":"integer","minimum":1,"maximum":3},"target_ratio":{"type":"number","minimum":0.1,"maximum":1},"on_reject":{"type":"string","enum":["accept_list","skip","require_target","best_quote"]}}},"provider":{"type":"object","additionalProperties":false,"properties":{"order":{"type":"array","maxItems":50,"items":{"type":"string"}},"only":{"type":"array","maxItems":50,"items":{"type":"string"}},"ignore":{"type":"array","maxItems":50,"items":{"type":"string"}},"allow_fallbacks":{"type":"boolean","default":true},"sort":{"type":"string","enum":["price","latency","quality","traction","relevance","value"]},"max_price_usd":{"type":"number","minimum":0},"max_price":{"type":"object","properties":{"request":{"type":"number","minimum":0}}},"preferred_max_latency_ms":{"type":"number","minimum":0},"require_parameters":{"type":"boolean","readOnly":true,"description":"Always true. Payload/schema safety is not caller-disableable."}}}}}}}},"responses":{"200":{"description":"Preview, successful free execution, or paid-provider direct handoff"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"402":{"description":"Payment required (x402)"},"403":{"description":"Ownership/authentication proof rejected","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"404":{"description":"Requested indexed resource was not found","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"409":{"description":"State conflict, stale quote, replay protection, or ambiguous execution","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"422":{"description":"More specific executable intent is required","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded"},"502":{"description":"Upstream provider execution failed"},"503":{"description":"Required production dependency is unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}}}}},"/api/verify":{"post":{"summary":"End-to-end execution verification for currently free indexed endpoints. Paid/x402 endpoints are not executed by AgentReeve in buyer-direct mode; use /api/route for a direct paid-provider handoff.","security":[{"x402":[]}],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"seller_payment_mode":"none_for_free_verification","paid_endpoint_behavior":"409 buyer-direct handoff required"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri"},"payload":{},"timeout_ms":{"type":"number","minimum":1000,"maximum":60000}},"additionalProperties":false}}}},"responses":{"200":{"description":"Free-endpoint verified execution completed"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"402":{"description":"Payment required (x402)"},"403":{"description":"Ownership/authentication proof rejected","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"404":{"description":"Requested indexed resource was not found","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"409":{"description":"State conflict, stale quote, replay protection, or ambiguous execution","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"422":{"description":"More specific executable intent is required","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded"},"502":{"description":"Upstream provider execution failed"},"503":{"description":"Required production dependency is unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}}}}},"/api/submit":{"post":{"summary":"Owner-verified endpoint listing. Obtain an ownership challenge first; payment is requested only after control is proven.","security":[{"x402":[]}],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"5"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url","ownership_token"],"properties":{"url":{"type":"string","format":"uri"},"ownership_token":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"category":{"type":"string"},"method":{"type":"string"},"input_schema":{"type":"object"},"output_schema":{"type":"object"},"verification_safe":{"type":"boolean","description":"Owner opt-in allowing non-read end-to-end verification."}},"additionalProperties":false}}}},"responses":{"200":{"description":"Endpoint listed and first review published"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"402":{"description":"Payment required (x402)"},"403":{"description":"Ownership/authentication proof rejected","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"404":{"description":"Requested indexed resource was not found","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"409":{"description":"State conflict, stale quote, replay protection, or ambiguous execution","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"422":{"description":"More specific executable intent is required","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded"},"502":{"description":"Upstream provider execution failed"},"503":{"description":"Required production dependency is unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}}}}},"/api/re-review":{"post":{"summary":"Re-probe, rescore and republish an already-indexed endpoint. Input validity/index membership is checked before payment.","security":[{"x402":[]}],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"10"},"settlement_asset":"USDC","network":"eip155:8453"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Paid action completed"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"402":{"description":"Payment required (x402)"},"403":{"description":"Ownership/authentication proof rejected","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"404":{"description":"Requested indexed resource was not found","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"409":{"description":"State conflict, stale quote, replay protection, or ambiguous execution","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"422":{"description":"More specific executable intent is required","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded"},"502":{"description":"Upstream provider execution failed"},"503":{"description":"Required production dependency is unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}}}}},"/api/feature":{"post":{"summary":"Buy exactly 24 hours of clearly labelled advertising for an indexed public endpoint. Advertising never affects score or rank.","security":[{"x402":[]}],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"24"},"settlement_asset":"USDC","network":"eip155:8453"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri"},"headline":{"type":"string","maxLength":120}},"additionalProperties":false}}}},"responses":{"200":{"description":"Paid action completed"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"402":{"description":"Payment required (x402)"},"403":{"description":"Ownership/authentication proof rejected","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"404":{"description":"Requested indexed resource was not found","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"409":{"description":"State conflict, stale quote, replay protection, or ambiguous execution","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"422":{"description":"More specific executable intent is required","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded"},"502":{"description":"Upstream provider execution failed"},"503":{"description":"Required production dependency is unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}}}}},"/api/free-intelligence":{"get":{"summary":"Paid reveal of identities/evidence for matching routable free providers. Public search surfaces expose aggregate counts only.","security":[{"x402":[]}],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"parameters":[{"name":"q","in":"query","required":false,"description":"Semantic job","schema":{"type":"string"}},{"name":"name","in":"query","required":false,"description":"Provider/domain/name search","schema":{"type":"string"}},{"name":"category","in":"query","required":false,"description":"Category filter","schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"description":"Zero-based cursor","schema":{"type":"integer","minimum":0}},{"name":"limit","in":"query","required":false,"description":"Page size or the string 'all' where supported","schema":{"oneOf":[{"type":"integer","minimum":1},{"type":"string","enum":["all"]}]}}],"responses":{"200":{"description":"Paid intelligence result"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"402":{"description":"Payment required (x402)"},"403":{"description":"Ownership/authentication proof rejected","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"404":{"description":"Requested indexed resource was not found","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"409":{"description":"State conflict, stale quote, replay protection, or ambiguous execution","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"422":{"description":"More specific executable intent is required","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded"},"502":{"description":"Upstream provider execution failed"},"503":{"description":"Required production dependency is unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}}}},"post":{"summary":"Paid reveal of identities/evidence for matching routable free providers.","security":[{"x402":[]}],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"settlement_asset":"USDC","network":"eip155:8453"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"},"name":{"type":"string"},"category":{"type":"string"},"cursor":{"type":"integer","minimum":0},"limit":{"oneOf":[{"type":"integer","minimum":1,"maximum":250},{"type":"string","enum":["all"]}]}},"additionalProperties":false}}}},"responses":{"200":{"description":"Paid action completed"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"402":{"description":"Payment required (x402)"},"403":{"description":"Ownership/authentication proof rejected","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"404":{"description":"Requested indexed resource was not found","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"409":{"description":"State conflict, stale quote, replay protection, or ambiguous execution","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"422":{"description":"More specific executable intent is required","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded"},"502":{"description":"Upstream provider execution failed"},"503":{"description":"Required production dependency is unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}}}}},"/api/ownership/challenge":{"post":{"summary":"Create a short-lived HTTP ownership proof challenge before submit, opt-out or adapter registration.","security":[],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"404":{"description":"Requested indexed resource was not found","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded"},"503":{"description":"Required production dependency is unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url","action"],"properties":{"url":{"type":"string","format":"uri"},"action":{"type":"string","enum":["submit","opt_out","adapter"]}},"additionalProperties":false}}}}}},"/api/opt-out":{"post":{"summary":"Owner-verified removal from probing, public boards and routing.","security":[],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"404":{"description":"Requested indexed resource was not found","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded"},"503":{"description":"Required production dependency is unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url","ownership_token"],"properties":{"url":{"type":"string","format":"uri"},"ownership_token":{"type":"string"}},"additionalProperties":false}}}}}},"/api/capabilities":{"get":{"summary":"Browse canonical plus dynamically observed capability IDs with aggregate indexed/routable supply.","security":[],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"404":{"description":"Requested indexed resource was not found","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded"},"503":{"description":"Required production dependency is unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}}},"parameters":[{"name":"category","in":"query","required":false,"description":"Category filter","schema":{"type":"string"}},{"name":"routable","in":"query","required":false,"description":"Set to 1 for capabilities with routable supply","schema":{"type":"string"}},{"name":"canonical","in":"query","required":false,"description":"Set to 1 for canonical registry entries only","schema":{"type":"string"}}]}},"/api/capabilities/search":{"get":{"summary":"Search the evidence-backed capability index across the full corpus.","security":[],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"404":{"description":"Requested indexed resource was not found","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded"},"503":{"description":"Required production dependency is unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}}},"parameters":[{"name":"q","in":"query","required":true,"description":"Natural-language executable job","schema":{"type":"string"}},{"name":"category","in":"query","required":false,"description":"Optional category scope","schema":{"type":"string"}}]}},"/api/capability-profile":{"get":{"summary":"Capability profile, evidence and verified adapters for one indexed endpoint.","security":[],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"404":{"description":"Requested indexed resource was not found","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded"},"503":{"description":"Required production dependency is unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}}},"parameters":[{"name":"url","in":"query","required":true,"description":"Exact indexed endpoint URL","schema":{"type":"string"}}]}},"/api/categories":{"get":{"summary":"Category-level indexed/recent/routable/negotiable supply and observed price statistics.","security":[],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"404":{"description":"Requested indexed resource was not found","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded"},"503":{"description":"Required production dependency is unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}}}}},"/api/search":{"get":{"summary":"Natural-language endpoint discovery. Free-provider identities remain protected; aggregate matching counts are returned.","security":[],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"404":{"description":"Requested indexed resource was not found","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded"},"503":{"description":"Required production dependency is unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}}},"parameters":[{"name":"q","in":"query","required":false,"description":"Natural-language job","schema":{"type":"string"}},{"name":"category","in":"query","required":false,"description":"Category filter","schema":{"type":"string"}},{"name":"routable","in":"query","required":false,"description":"1 = routable only","schema":{"type":"string"}},{"name":"free","in":"query","required":false,"description":"1 = free only; identities may still be protected","schema":{"type":"string"}},{"name":"negotiable","in":"query","required":false,"description":"1 = side-effect-free quote-only negotiation support only","schema":{"type":"string"}},{"name":"max_price_usd","in":"query","required":false,"description":"Seller-price ceiling","schema":{"type":"number","minimum":0}},{"name":"cursor","in":"query","required":false,"description":"Zero-based cursor","schema":{"type":"integer","minimum":0}},{"name":"limit","in":"query","required":false,"description":"Page size or the string 'all' where supported","schema":{"oneOf":[{"type":"integer","minimum":1},{"type":"string","enum":["all"]}]}}]}},"/api/endpoints/search":{"get":{"summary":"Search provider identity by name/title/domain/URL; use capability search for jobs.","security":[],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"404":{"description":"Requested indexed resource was not found","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded"},"503":{"description":"Required production dependency is unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}}},"parameters":[{"name":"q","in":"query","required":true,"description":"Provider/name/domain/URL","schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"description":"Zero-based cursor","schema":{"type":"integer","minimum":0}},{"name":"limit","in":"query","required":false,"description":"Page size or the string 'all' where supported","schema":{"oneOf":[{"type":"integer","minimum":1},{"type":"string","enum":["all"]}]}}]}},"/api/board/{category}":{"get":{"summary":"Ranked public endpoints for one category.","security":[],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"404":{"description":"Requested indexed resource was not found","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded"},"503":{"description":"Required production dependency is unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}}},"parameters":[{"name":"category","in":"path","required":true,"schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"score|cheapest|fastest|proven","schema":{"type":"string"}},{"name":"include_outliers","in":"query","required":false,"description":"1 = include high-price endpoints without observed payment activity","schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"description":"Zero-based cursor","schema":{"type":"integer","minimum":0}},{"name":"limit","in":"query","required":false,"description":"Page size or the string 'all' where supported","schema":{"oneOf":[{"type":"integer","minimum":1},{"type":"string","enum":["all"]}]}}]}},"/api/board/new":{"get":{"summary":"Newest public endpoint arrivals.","security":[],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"404":{"description":"Requested indexed resource was not found","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded"},"503":{"description":"Required production dependency is unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}}},"parameters":[{"name":"cursor","in":"query","required":false,"description":"Zero-based cursor","schema":{"type":"integer","minimum":0}},{"name":"limit","in":"query","required":false,"description":"Page size or the string 'all' where supported","schema":{"oneOf":[{"type":"integer","minimum":1},{"type":"string","enum":["all"]}]}}]}},"/api/board/negotiable":{"get":{"summary":"Public sellers advertising the side-effect-free quote-only negotiation extension.","security":[],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"404":{"description":"Requested indexed resource was not found","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded"},"503":{"description":"Required production dependency is unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}}},"parameters":[{"name":"cursor","in":"query","required":false,"description":"Zero-based cursor","schema":{"type":"integer","minimum":0}},{"name":"limit","in":"query","required":false,"description":"Page size or the string 'all' where supported","schema":{"oneOf":[{"type":"integer","minimum":1},{"type":"string","enum":["all"]}]}}]}},"/api/board/free":{"get":{"summary":"Aggregate count of protected free-provider supply. Identities are not disclosed here.","security":[],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"404":{"description":"Requested indexed resource was not found","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded"},"503":{"description":"Required production dependency is unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}}}}},"/api/adapters":{"get":{"summary":"Verified deterministic adapters registered for an endpoint.","security":[],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"404":{"description":"Requested indexed resource was not found","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded"},"503":{"description":"Required production dependency is unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}}},"parameters":[{"name":"url","in":"query","required":true,"description":"Exact indexed endpoint URL","schema":{"type":"string"}}]}},"/api/adapters/register":{"post":{"summary":"Owner-verified deterministic adapter registration. Runtime LLM-generated mappings are not accepted.","security":[],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"404":{"description":"Requested indexed resource was not found","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded"},"503":{"description":"Required production dependency is unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url","capability_id","ownership_token","input_map"],"additionalProperties":true,"properties":{"url":{"type":"string","format":"uri"},"capability_id":{"type":"string"},"ownership_token":{"type":"string"},"input_map":{"type":"object"},"output_map":{"type":"object"},"constants":{"type":"object"},"passthrough":{"type":"boolean"}}}}}}}},"/api/reputation":{"get":{"summary":"Observed score, evidence, probe history and payment-activity caveats for one indexed endpoint.","security":[],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"404":{"description":"Requested indexed resource was not found","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded"},"503":{"description":"Required production dependency is unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}}},"parameters":[{"name":"url","in":"query","required":true,"description":"Exact indexed endpoint URL","schema":{"type":"string"}}]}},"/api/resources":{"get":{"summary":"Live public index. Protected free-provider identities are excluded.","security":[],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"404":{"description":"Requested indexed resource was not found","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded"},"503":{"description":"Required production dependency is unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}}}}},"/api/emerging":{"get":{"summary":"Emerging/unclassified capability clusters from public indexed supply.","security":[],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"404":{"description":"Requested indexed resource was not found","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded"},"503":{"description":"Required production dependency is unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}}}}},"/api/featured":{"get":{"summary":"Currently served labelled advertising slots.","security":[],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"404":{"description":"Requested indexed resource was not found","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded"},"503":{"description":"Required production dependency is unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}}},"parameters":[{"name":"slots","in":"query","required":false,"description":"Number of slots, 1–10","schema":{"type":"integer","minimum":1,"maximum":10}}]}},"/api/featured/queue":{"get":{"summary":"Public featured-placement queue ordered by least impressions served.","security":[],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"404":{"description":"Requested indexed resource was not found","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded"},"503":{"description":"Required production dependency is unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}}}}},"/api/pricing":{"get":{"summary":"Authoritative public price list. Route fee is an AgentReeve fee only; the buyer pays any paid seller separately/directly.","security":[],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"404":{"description":"Requested indexed resource was not found","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded"},"503":{"description":"Required production dependency is unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}}}}},"/api/sources":{"get":{"summary":"Discovery/probe work configuration, source endpoints and dataset counts.","security":[],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"404":{"description":"Requested indexed resource was not found","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded"},"503":{"description":"Required production dependency is unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}}}}},"/api/agentreeve":{"get":{"summary":"Self-describing action manifest and prices.","security":[],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"404":{"description":"Requested indexed resource was not found","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded"},"503":{"description":"Required production dependency is unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}}}},"post":{"summary":"Single dispatch endpoint for AgentReeve actions. Action-specific routes remain authoritative.","security":[],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"404":{"description":"Requested indexed resource was not found","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded"},"503":{"description":"Required production dependency is unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}},"additionalProperties":true}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["action"],"properties":{"action":{"type":"string"}},"additionalProperties":true}}}}}}}}