{"uid":"cap_8s0zXVo7RZnAeBJUfDQTY","slug":"gedx402-vector-upsert-f43e3f13","name":"GEDX402 Vector Upsert","description":"x402 workers ai. pay with usdc on base, polygon, arbitrum, world, or solana. no api keys.","url":"https://search.gedx402.com/v1/search/upsert","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"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."},"namespace":{"type":"string","description":"Agent collection id (2-64 chars). Isolates vectors per agent or project."}}},"responseSchema":{"type":"json","example":{"id":"doc-1","mutationId":"…"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_dQmdmkLCEqgvyMsrIYMw1","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Embeds and stores a document (text + metadata) into an isolated vector namespace for later semantic search, paid per call via USDC on-chain.","exampleAgentPrompt":"Store this product description in my 'product-catalog' namespace with id 'prod-9921': 'The AeroGlide X1 is a lightweight carbon-fiber drone with 40-minute flight time, 4K camera, and obstacle avoidance — ideal for professional aerial photography.'","exampleUseCases":null,"resultDescription":"A JSON object confirming the upsert with the document's stable id (e.g. 'doc-1') and a mutationId string that can be used to track or verify the write operation.","failureModes":["Missing required 'text' field — document cannot be embedded without content","Invalid or missing 'namespace' (must be 2–64 characters) — request rejected","Duplicate 'id' within namespace — overwrites existing document silently (idempotent)","Payment failure or insufficient USDC balance — 402 response, request not processed","Malformed metadata object — may cause schema validation error","Namespace not found or permission mismatch — vector isolation enforced per agent"],"whenToPreferThis":"Choose this endpoint when you need to add or update a single document in an isolated vector namespace using crypto micropayments with no API key setup. Ideal for AI agents building or maintaining a semantic memory layer, knowledge base, or retrieval-augmented generation (RAG) pipeline, especially when operating in a permissionless, keyless environment funded by on-chain USDC (Base, Polygon, Arbitrum, World, or Solana).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:31:56.295Z","isFirstParty":false}