# GEDX402 Batch Document Upsert

> GEDX402 Batch Document Upsert is a paid API for AI agents from search.gedx402.com, paid per call via x402, $0.06/call, status unknown (last checked 2026-09-16).

Batch-inserts or updates documents (with embeddings) into a namespaced vector collection, payable via USDC on-chain with no API keys.

## Facts

- Endpoint: GET https://search.gedx402.com/v1/search/upsert/batch
- Price: $0.06/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gedx402-batch-document-upsert-bada2958
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rB2cs8OsBIH9C5JBWoZY_

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability gedx402-batch-document-upsert-bada2958
```

Example prompt: Index these 3 documents into my 'project-alpha' namespace: {id: 'doc1', text: 'Cloudflare Workers are serverless functions...'}, {id: 'doc2', text: 'Vector search enables semantic retrieval...'}, {id: 'doc3', text: 'x402 allows micropayments for APIs...'} — no API key, pay with USDC on Base.

## When to prefer this

Choose this endpoint when you need to bulk-load or update multiple documents into a namespaced vector store in a single call, especially when you want to avoid managing API keys and prefer paying per-use in USDC on Base, Polygon, Arbitrum, World, or Solana. Ideal for agent memory systems, knowledge base indexing, or RAG pipeline ingestion.

## Known failure modes

- Invalid document format — missing required 'id' or 'text' fields returns a 400 error
- Namespace string outside 2-64 character range causes a validation failure
- Payment not completed or insufficient USDC balance results in a 402 Payment Required response
- Empty documents array returns an error or zero upserted count
- Unsupported blockchain network for payment causes transaction rejection

## How this service works

Batch upsert up to 64 documents into a namespace — one paid request for agent memory ingest.

## Output

A JSON object confirming how many documents were successfully upserted, e.g. {"upserted": 2}. The count reflects the number of documents processed and stored in the specified namespace.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "documents": {
   "type": "array",
   "items": {
    "type": "object"
   }
  },
  "namespace": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gedx402-batch-document-upsert-bada2958/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from search.gedx402.com](https://www.zero.xyz/host/search.gedx402.com/llms.txt)