# storage.gedx402.com Object Retrieval

> storage.gedx402.com Object Retrieval is a paid API for AI agents from storage.gedx402.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Retrieve a stored object by key from Cloudflare R2 object storage, paying per-call with USDC via the x402 protocol — no API key required.

## Facts

- Endpoint: PUT https://storage.gedx402.com/v1/objects/:key
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/storage-gedx402-com-object-retrieval-5744a529
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KVbHBRH0clKLkz2yqmfmf

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 storage-gedx402-com-object-retrieval-5744a529 -d '<json body>'
```

Example prompt: Can you fetch the stored object at key 'agent/run-1/output.json' from the x402 storage service — I'll pay the 0.005 USDC fee with USDC on Base.

## When to prefer this

Choose this endpoint when you need to retrieve a specific object from cloud storage without managing API keys, and you can pay per-call in USDC on Base, Polygon, Arbitrum, World, or Solana. Ideal for agent workflows that store and retrieve intermediate or final artifacts by key.

## Known failure modes

- Object key not found — 404 response
- Insufficient USDC payment or unsupported payment network — 402 payment required
- Invalid or malformed object key — 400 bad request
- Payment network timeout or blockchain confirmation failure
- Rate limiting or storage service unavailability — 503

## How this service works

Agent artifact storage on storage.gedx402.com. PUT object bytes (raw or JSON base64), GET bytes, DELETE key; HEAD metadata is free. Pay USDC per mutating request. Bundle: GET /v1/models?bundle=artifacts. Pair with browser extract/persist and images-api transform.

## Output

Returns a JSON object containing the object's key, ETag, size in bytes, the underlying storage service name (cloudflare-r2), and the content type of the stored object.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "key": "agent/run-1/output.json",
  "etag": "\"abc\"",
  "size": 4,
  "service": "gedx402-storage",
  "content_type": "application/octet-stream"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/storage-gedx402-com-object-retrieval-5744a529/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from storage.gedx402.com](https://www.zero.xyz/host/storage.gedx402.com/llms.txt)