# DataStore API – Temporary Item Storage

> DataStore API – Temporary Item Storage is a paid API for AI agents from fileshareforagents.online, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-17).

Stores any content (JSON, text, Markdown, CSV, HTML, image, PDF, etc.) for up to 365 days (default 7) and returns a unique item ID, a one-time secret, expiry timestamp, and links to retrieve, extend, share, or delete the item.

## Facts

- Endpoint: POST https://fileshareforagents.online/v1/items?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/datastore-api-temporary-item-storage-ea82bc68
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PCiYDQFut5xgyMyZ6cJZ9

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 datastore-api-temporary-item-storage-ea82bc68 -d '<json body>'
```

Example prompt: Save this JSON payload for me so I can share it with another agent — keep it for 7 days and label it 'order-summary': {"orderId": "ORD-4821", "total": 49.99, "status": "confirmed"}.

## When to prefer this

Choose this endpoint when an AI agent needs to temporarily persist arbitrary content (JSON, text, CSV, images, PDFs, etc.) and retrieve it later via a stable URL, especially in multi-agent pipelines, cross-session handoffs, or when a shareable public download link is needed. Prefer it over in-memory state when data must survive beyond a single session or be accessible to external agents or humans. The x402 micropayment model (0.01 USDC) makes it suitable for agent-native, wallet-enabled workflows.

## Known failure modes

- Payload exceeds 26,214,400 bytes — request rejected
- ttl_days outside 1–365 range — validation error
- Label longer than 100 characters — validation error
- Payment not included or insufficient (x402 payment required, 0.01 USDC on Base)
- Unsupported content type — rejection
- Network timeout on large uploads
- Secret lost after initial response — item becomes unmanageable (no recovery)

## How this service works

Store JSON or a file (up to 25 MB) privately for 7 days and hand it to a human or another agent with a signed link or a password-protected address. Includes 100 reads. No account needed: pay $0.01 per call here, or use prepaid credits with an API key, or store public items free at /v1/free/items. Docs: https://fileshareforagents.online/llms.txt

## Output

A JSON object containing: item ID (e.g. itm_Dknq-...), a one-time bearer secret (shown only once, required for all subsequent operations on the item), expiry datetime, content type, size in bytes, remaining reads count, and a set of HTTPS links for self-retrieval, reads tracking, sharing, extending TTL, deleting, and a public download URL.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "description": "The raw content to store is the request body (JSON shown here; text, Markdown, CSV, HTML, SVG, PDF, PNG, JPEG, WebP or GIF also accepted, up to 26214400 bytes). Options are query parameters: ttl_days (1..365, default 7) and label (<= 100 chars). The response holds the item id, a one-time secret, expiry, and links to retrieve, extend, buy reads, share and delete. Alternatives: POST /v1/free/items stores a public item for up to 7 days at no cost; an X-Api-Key from a dashboard account pays with prepaid credits instead of x402. See /llms.txt.",
     "additionalProperties": true
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "id",
      "secret",
      "expires_at",
      "links"
     ],
     "properties": {
      "id": {
       "type": "string"
      },
      "links": {
       "type": "object"
      },
      "secret": {
       "type": "string",
       "description": "Bearer credential for every later call on this item. Shown once."
      },
      "expires_at": {
       "type": "string",
       "format": "date-time"
      },
      "reads_remaining": {
       "type": "integer"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "id": "itm_Dknq-kzeOK-HrU3O-HezFA",
  "size": 46,
  "links": {
   "self": "https://fileshareforagents.online/v1/items/{id}",
   "reads": "https://fileshareforagents.online/v1/items/{id}/reads",
   "share": "https://fileshareforagents.online/v1/items/{id}/links",
   "delete": "https://fileshareforagents.online/v1/items/{id}",
   "extend": "https://fileshareforagents.online/v1/items/{id}/extend",
   "public": "https://share.fileshareforagents.online/d/{id}",
   "status": "https://fileshareforagents.online/v1/items/{id}/status"
  },
  "secret": "sk_<shown once>",
  "payment": {
   "tx": "0x...",
   "amount": "0.01",
   "network": "base",
   "currency": "USDC"
  },
  "created_at": "2026-09-17T17:46:35.362Z",
  "expires_at": "2026-09-24T17:46:35.362Z",
  "content_type": "application/json",
  "has_password": false,
  "reads_remaining": 100
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/datastore-api-temporary-item-storage-ea82bc68/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fileshareforagents.online](https://www.zero.xyz/host/fileshareforagents.online/llms.txt)