{"openapi":"3.1.0","info":{"title":"GEDX402 Search","version":"4","description":"Agent memory and semantic search on Cloudflare Vectorize — upsert text, query by meaning, raw vector ops. Namespaces isolate collections.","contact":{"email":"jvalamis@gmail.com","url":"https://search.gedx402.com"},"x-guidance":"Pay per request with USDC on Base, Polygon, Arbitrum, World, Solana via x402 v2 (Coinbase CDP facilitator). Choose any listed network in the 402 accepts[] response. 6 routes on this shard. Full catalog: GET https://gedx402.com/v1/models","x-service":{"serviceName":"GEDX402 Search","tags":["rag","vectorize","semantic-search","embeddings","agents","usdc","multi-chain"],"iconUrl":"https://search.gedx402.com/favicon.svg"},"x-hub":"https://gedx402.com","x-payments":[{"x402":{"network":"eip155:8453","asset":"USDC","label":"Base"}},{"x402":{"network":"eip155:137","asset":"USDC","label":"Polygon"}},{"x402":{"network":"eip155:42161","asset":"USDC","label":"Arbitrum"}},{"x402":{"network":"eip155:480","asset":"USDC","label":"World"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","asset":"USDC","label":"Solana"}}]},"servers":[{"url":"https://search.gedx402.com"}],"paths":{"/v1/search/query":{"post":{"operationId":"search_query","summary":"BGE Base EN V1.5 Semantic Search","description":"Semantic search over your namespace. POST query text; embeds with BGE-base and returns top_k Vectorize matches with scores and metadata.","tags":["Search"],"x-payment-info":{"protocols":[{"x402":{"network":"eip155:8453","asset":"USDC","label":"Base"}},{"x402":{"network":"eip155:137","asset":"USDC","label":"Polygon"}},{"x402":{"network":"eip155:42161","asset":"USDC","label":"Arbitrum"}},{"x402":{"network":"eip155:480","asset":"USDC","label":"World"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","asset":"USDC","label":"Solana"}}],"price":{"mode":"dynamic","currency":"USD","min":"0.006000","max":"0.020000"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"namespace":{"type":"string","description":"Agent collection id (2-64 chars). Isolates vectors per agent or project."},"query":{"type":"string","description":"Natural-language search query."},"top_k":{"type":"integer","description":"Max results (1-50)."},"return_metadata":{"type":"boolean","description":"Include stored metadata in matches."}},"required":["namespace","query"]},"example":{"namespace":"my-agent","query":"How does Workers AI pricing work?","top_k":5}}}},"responses":{"200":{"description":"Inference result","content":{"application/json":{"schema":{"type":"object"},"example":{"matches":[{"id":"doc-1","score":0.91,"metadata":{"text":"..."}}],"count":1}}}},"400":{"description":"Invalid or over-limit payload"},"402":{"description":"Payment required (x402 v2 USDC on Base, Polygon, Arbitrum, World, Solana)","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 PaymentRequired with accepts[] per network","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{}}}}}}},"/v1/search/upsert":{"post":{"operationId":"search_upsert","summary":"BGE Base EN V1.5 Semantic Search","description":"Upsert one text document into your namespace. Embeds with BGE-base (768-dim) and stores in Cloudflare Vectorize for RAG pipelines.","tags":["Search"],"x-payment-info":{"protocols":[{"x402":{"network":"eip155:8453","asset":"USDC","label":"Base"}},{"x402":{"network":"eip155:137","asset":"USDC","label":"Polygon"}},{"x402":{"network":"eip155:42161","asset":"USDC","label":"Arbitrum"}},{"x402":{"network":"eip155:480","asset":"USDC","label":"World"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","asset":"USDC","label":"Solana"}}],"price":{"mode":"dynamic","currency":"USD","min":"0.008000","max":"0.025000"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"namespace":{"type":"string","description":"Agent collection id (2-64 chars). Isolates vectors per agent or project."},"id":{"type":"string","description":"Stable document id within the namespace."},"text":{"type":"string","description":"Document text to embed and store."},"metadata":{"type":"object","description":"Optional metadata stored with the vector."}},"required":["namespace","id","text"]},"example":{"namespace":"my-agent","id":"doc-1","text":"Workers AI runs at the edge."}}}},"responses":{"200":{"description":"Inference result","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"doc-1","mutationId":"…"}}}},"400":{"description":"Invalid or over-limit payload"},"402":{"description":"Payment required (x402 v2 USDC on Base, Polygon, Arbitrum, World, Solana)","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 PaymentRequired with accepts[] per network","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{}}}}}}},"/v1/search/upsert/batch":{"post":{"operationId":"search_upsert_batch","summary":"BGE Base EN V1.5 Semantic Search","description":"Batch upsert up to 64 documents into a namespace. One paid request for agent memory ingest.","tags":["Search"],"x-payment-info":{"protocols":[{"x402":{"network":"eip155:8453","asset":"USDC","label":"Base"}},{"x402":{"network":"eip155:137","asset":"USDC","label":"Polygon"}},{"x402":{"network":"eip155:42161","asset":"USDC","label":"Arbitrum"}},{"x402":{"network":"eip155:480","asset":"USDC","label":"World"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","asset":"USDC","label":"Solana"}}],"price":{"mode":"dynamic","currency":"USD","min":"0.015000","max":"0.060000"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"namespace":{"type":"string","description":"Agent collection id (2-64 chars). Isolates vectors per agent or project."},"documents":{"type":"array","description":"Batch documents with id + text.","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"metadata":{"type":"object"}},"required":["id","text"]}}},"required":["namespace","documents"]},"example":{"namespace":"my-agent","documents":[{"id":"a","text":"first"},{"id":"b","text":"second"}]}}}},"responses":{"200":{"description":"Inference result","content":{"application/json":{"schema":{"type":"object"},"example":{"upserted":2}}}},"400":{"description":"Invalid or over-limit payload"},"402":{"description":"Payment required (x402 v2 USDC on Base, Polygon, Arbitrum, World, Solana)","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 PaymentRequired with accepts[] per network","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{}}}}}}},"/v1/search/delete":{"post":{"operationId":"search_delete","summary":"Cloudflare Vectorize Vector DB","description":"Upsert or query raw vectors in Vectorize (768-dim, cosine). Namespace isolates agent collections.","tags":["Vectors"],"x-payment-info":{"protocols":[{"x402":{"network":"eip155:8453","asset":"USDC","label":"Base"}},{"x402":{"network":"eip155:137","asset":"USDC","label":"Polygon"}},{"x402":{"network":"eip155:42161","asset":"USDC","label":"Arbitrum"}},{"x402":{"network":"eip155:480","asset":"USDC","label":"World"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","asset":"USDC","label":"Solana"}}],"price":{"mode":"dynamic","currency":"USD","min":"0.004000","max":"0.012000"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"namespace":{"type":"string","description":"Agent collection id (2-64 chars). Isolates vectors per agent or project."},"ids":{"type":"array","items":{"type":"string"},"description":"Document ids to delete."}},"required":["namespace","ids"]},"example":{"namespace":"my-agent","ids":["doc-1"]}}}},"responses":{"200":{"description":"Inference result","content":{"application/json":{"schema":{"type":"object"},"example":{"deleted":1}}}},"400":{"description":"Invalid or over-limit payload"},"402":{"description":"Payment required (x402 v2 USDC on Base, Polygon, Arbitrum, World, Solana)","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 PaymentRequired with accepts[] per network","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{}}}}}}},"/v1/vector/query":{"post":{"operationId":"vector_query","summary":"Cloudflare Vectorize Vector DB","description":"Query Vectorize by raw 768-dim vector in your namespace. For agents that embed locally.","tags":["Vectors"],"x-payment-info":{"protocols":[{"x402":{"network":"eip155:8453","asset":"USDC","label":"Base"}},{"x402":{"network":"eip155:137","asset":"USDC","label":"Polygon"}},{"x402":{"network":"eip155:42161","asset":"USDC","label":"Arbitrum"}},{"x402":{"network":"eip155:480","asset":"USDC","label":"World"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","asset":"USDC","label":"Solana"}}],"price":{"mode":"dynamic","currency":"USD","min":"0.004000","max":"0.015000"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"namespace":{"type":"string","description":"Agent collection id (2-64 chars). Isolates vectors per agent or project."},"vector":{"type":"array","items":{"type":"number"},"description":"768-dim query vector."},"top_k":{"type":"integer","description":"Max results (1-50)."},"return_metadata":{"type":"boolean","description":"Include stored metadata in matches."},"return_values":{"type":"boolean","description":"Include raw vector values in matches."}},"required":["namespace","vector"]},"example":{"namespace":"my-agent","vector":[0.1,0.2],"top_k":5}}}},"responses":{"200":{"description":"Inference result","content":{"application/json":{"schema":{"type":"object"},"example":{"matches":[],"count":0}}}},"400":{"description":"Invalid or over-limit payload"},"402":{"description":"Payment required (x402 v2 USDC on Base, Polygon, Arbitrum, World, Solana)","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 PaymentRequired with accepts[] per network","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{}}}}}}},"/v1/vector/upsert":{"post":{"operationId":"vector_upsert","summary":"Cloudflare Vectorize Vector DB","description":"Upsert or query raw vectors in Vectorize (768-dim, cosine). Namespace isolates agent collections.","tags":["Vectors"],"x-payment-info":{"protocols":[{"x402":{"network":"eip155:8453","asset":"USDC","label":"Base"}},{"x402":{"network":"eip155:137","asset":"USDC","label":"Polygon"}},{"x402":{"network":"eip155:42161","asset":"USDC","label":"Arbitrum"}},{"x402":{"network":"eip155:480","asset":"USDC","label":"World"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","asset":"USDC","label":"Solana"}}],"price":{"mode":"dynamic","currency":"USD","min":"0.006000","max":"0.020000"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"namespace":{"type":"string","description":"Agent collection id (2-64 chars). Isolates vectors per agent or project."},"vectors":{"type":"array","description":"Raw vectors for upsert (768 dims for default index).","items":{"type":"object","properties":{"id":{"type":"string"},"values":{"type":"array","items":{"type":"number"}},"metadata":{"type":"object"}},"required":["id","values"]}}},"required":["namespace","vectors"]},"example":{"namespace":"my-agent","vectors":[{"id":"v1","values":[0.1,0.2]}]}}}},"responses":{"200":{"description":"Inference result","content":{"application/json":{"schema":{"type":"object"},"example":{"upserted":1}}}},"400":{"description":"Invalid or over-limit payload"},"402":{"description":"Payment required (x402 v2 USDC on Base, Polygon, Arbitrum, World, Solana)","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 PaymentRequired with accepts[] per network","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{}}}}}}},"/v1/models":{"get":{"operationId":"models","summary":"Shard route catalog","description":"Free catalog for this shard with pricing and descriptions.","tags":["Catalog"],"responses":{"200":{"description":"Catalog JSON"}}}},"/v1/demo":{"get":{"operationId":"demo_index","summary":"Response shape previews","description":"Free cached JSON examples (not charged).","tags":["Catalog"],"responses":{"200":{"description":"Demo index"}}}},"/v1/health":{"get":{"operationId":"health","summary":"Service health","tags":["Catalog"],"responses":{"200":{"description":"Health JSON"}}}}},"x-discovery":{"ownershipProofs":["0xb3C2776cE3F99cb3366520c27b4aC5D436942Ab6","6X7E1kWxiDb9KMVBWpj1vhGLngaH9nBJS31YUyrG2mwq"]}}