{"uid":"cap_DvHeD4mImY92-6ohos9h2","slug":"gedx402-vector-upsert-84a3c386","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/vector/upsert","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"vectors":{"type":"array","items":{"type":"object","required":["id","values"],"properties":{"id":{"type":"string"},"values":{"type":"array","items":{"type":"number"}},"metadata":{"type":"object"}}},"description":"Raw vectors for upsert (768 dims for default index)."},"namespace":{"type":"string","description":"Agent collection id (2-64 chars). Isolates vectors per agent or project."}}},"responseSchema":{"type":"json","example":{"upserted":1}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.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_z1Y7gYNl8t5P0fzVrmyd2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Upserts raw embedding vectors into a namespaced vector index, paid per-call with USDC via x402 protocol, no API keys required.","exampleAgentPrompt":"Store these two 768-dimension embeddings into my 'project-alpha' namespace: first vector with id 'doc-001' and values [0.12, 0.45, ...], second with id 'doc-002' and values [0.33, 0.77, ...], both with metadata {source: 'wiki'}.","exampleUseCases":null,"resultDescription":"Returns a JSON object confirming how many vectors were upserted, e.g. {\"upserted\": 1}. No API key required; payment is handled automatically via x402 USDC on supported chains.","failureModes":["Invalid vector dimensions (not 768 floats) — likely 422 or 400 error","Namespace too short or too long (must be 2-64 chars) — validation error","Missing required vector id or values fields — 400 bad request","Payment not accepted or insufficient USDC balance — 402 payment required","Vector array is empty — may return upserted: 0 or validation error"],"whenToPreferThis":"Choose this endpoint when you need to store embedding vectors without managing API keys, want to pay per-call in USDC via x402 on Base, Polygon, Arbitrum, World, or Solana, and require namespace isolation per agent or project. Ideal for serverless RAG pipelines or agent memory systems built on Cloudflare Workers AI with 768-dim embeddings.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:40:14.856Z","isFirstParty":false}