# AgentBodega Artifact Hosting

> AgentBodega Artifact Hosting is a paid API for AI agents from agentbodega.store, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Stores arbitrary content (text, JSON, binary) as a hosted artifact and returns a signed URL for retrieval, with optional TTL-based expiry.

## Facts

- Endpoint: POST https://agentbodega.store/api/artifacts
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentbodega-artifact-hosting-c8b62383
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yQgPNYQNZXKBKXB6HPYv_

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 agentbodega-artifact-hosting-c8b62383 -d '<json body>'
```

Example prompt: Store this JSON report as a hosted artifact with a 24-hour expiry — the kind is 'json', and here's the content: {"summary": "Q2 results", "total": 42000} — and give me back the signed URL I can share.

## When to prefer this

Use this endpoint when an AI agent needs to externalize output — a report, a JSON blob, a binary — as a retrievable URL for sharing, handoff to another agent, or downstream consumption, and when paying per-call via x402 micropayments is acceptable. Prefer this over full S3/cloud storage when you need a lightweight, instant, no-setup hosted link with optional TTL, especially within agent pipelines already using the AgentBodega x402 ecosystem.

## Known failure modes

- Missing required fields 'kind' or 'content' results in a 400 validation error
- Content too large for the $0.01 tier may be rejected
- Payment not completed via x402 protocol returns a 402 Payment Required response
- Invalid contentType string may cause storage or retrieval issues
- Expired artifacts return a 404 or access-denied when fetched after TTL

## How this service works

Small x402-payable utility APIs for agents: endpoint inspection, launch checks, and hosted artifacts.

## Output

Returns a JSON object containing the size of the stored artifact in bytes, an ISO 8601 expiry timestamp, and a signed hosted URL where the artifact can be retrieved until it expires.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "body": {
     "fields": [
      {
       "name": "kind",
       "type": "string",
       "required": true
      },
      {
       "name": "content",
       "type": "any",
       "required": true
      },
      {
       "name": "contentType",
       "type": "string",
       "required": false
      },
      {
       "name": "ttlSeconds",
       "type": "integer",
       "required": false
      },
      {
       "name": "filename",
       "type": "string",
       "required": false
      }
     ],
     "required": [
      "kind",
      "content"
     ],
     "fieldCount": 5,
     "contentType": "application/json",
     "optionalPreview": [
      "contentType",
      "ttlSeconds",
      "filename"
     ],
     "omittedFieldCount": 0
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json"
     ],
     "type": "string"
    }
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string",
     "const": "json"
    },
    "example": {
     "type": "object",
     "additionalProperties": true
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "bytes": 128,
  "expiresAt": "2026-07-04T16:00:00.000Z",
  "artifactUrl": "signed hosted URL"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentbodega-artifact-hosting-c8b62383/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentbodega.store](https://www.zero.xyz/host/agentbodega.store/llms.txt)