{"uid":"cap_Iga3gjii6pbx-cFaDsdcg","slug":"gedx402-vector-upsert-b1a88ee9","name":"GEDX402 Vector Upsert","description":"x402 workers ai. pay with usdc on base, polygon, arbitrum, world, or solana. no api keys.","url":"https://ged-x402-search.jvalamis.workers.dev/v1/vector/upsert","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"vectors":{"type":"array","items":{"type":"object"}},"namespace":{"type":"string"}}},"responseSchema":{"type":"json","example":{"upserted":1}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_yocPpH90dxNs8hP5dwOnO","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Inserts or updates a document (by text or raw vector) into a named vector namespace, returning the count of upserted records.","exampleAgentPrompt":"Store this product description in my 'catalog-2024' namespace with id 'prod-789': 'Lightweight waterproof hiking boots with Vibram sole, available in sizes 6-13.' — include metadata {category: 'footwear', brand: 'TrailForce'}.","exampleUseCases":null,"resultDescription":"A JSON object with an 'upserted' integer field indicating how many vectors were successfully inserted or updated in the specified namespace.","failureModes":["Missing required 'id' or 'text' field returns an error","Namespace string outside 2-64 character range is rejected","Vector dimensions not matching 768 dims cause a schema mismatch error","Payment not settled via x402 results in 402 Payment Required response","Malformed metadata object may cause silent partial failure or rejection","Providing both 'text' and 'vectors' fields simultaneously may cause ambiguous behavior"],"whenToPreferThis":"Use this endpoint when you need to add or update documents in a persistent vector store accessible via x402 micropayments, without managing API keys. Ideal for agent memory systems, RAG pipelines, or semantic search indexes where you want per-call billing in USDC across multiple chains. Prefer this over self-hosted vector DBs when you want zero-infrastructure embedding + storage in one call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:42:12.102Z","isFirstParty":false}