# agent-exec Storage Object Renewal

> agent-exec Storage Object Renewal is a paid API for AI agents from agent-exec.448c.org, paid per call via x402, $0.0051/call, status unknown (last checked 2026-10-10).

Renews the retention window of a stored object in the agent-exec sandbox by paying per-use via HTTP 402, extending its expiry without losing existing time.

## Facts

- Endpoint: POST https://agent-exec.448c.org/storage/%7Bid%7D/renew?utm_source=zero.xyz
- Price: $0.0051/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-exec-storage-object-renewal-900af2ca
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_F1BnXUfsx5ScV8eDRsVcy

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 agent-exec-storage-object-renewal-900af2ca -d '<json body>'
```

Example prompt: Renew the agent-exec storage object with ID abc123 on the medium plan so it doesn't expire — go ahead and pay the USDC fee.

## When to prefer this

Use this endpoint when you have an existing stored object in agent-exec that is approaching expiry and you want to extend its retention window without losing any remaining time. Ideal for long-running agent pipelines where intermediate results need to be preserved across steps, or when you want to pay only for additional storage time on demand without committing to an account or subscription.

## Known failure modes

- Object ID not found or already freed — 404 response
- Insufficient payment or payment rejected — 402 response with correct pricing
- Invalid plan enum value — validation error
- Plan specified is too small for the object's current size — automatically upgraded to the smallest valid plan
- Payment network or wallet issues causing transaction failure

## How this service works

Accountless, pay-per-use code execution for software agents: submit source code, get stdout, stderr and exit code back from an isolated, network-less sandbox. No account, no API key -- possession of valid payment is sufficient.

## Output

Returns the object's new expiry timestamp (Unix ms), the previous expiry timestamp, the plan used, the object ID, and payment details including the payer wallet address, amount charged in atomic USDC units, network, and on-chain transaction hash.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "plan": {
   "enum": [
    "small",
    "medium",
    "large",
    "year"
   ],
   "type": "string",
   "description": "Optional. Which plan to buy. Its retention window is ADDED to whatever the object has left, never substituted for it, so renewing early forfeits nothing. Omitted, misspelled or too small for the object, you get the smallest plan that holds the object, and the 402 quotes exactly that."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "id",
  "expiresAt",
  "previousExpiresAt",
  "plan",
  "payment"
 ],
 "properties": {
  "id": {
   "type": "string"
  },
  "note": {
   "type": "object",
   "properties": {
    "code": {
     "enum": [
      "STORAGE_RENEWAL_PLAN_TOO_SMALL"
     ],
     "type": "string"
    },
    "details": {
     "type": "object"
    },
    "message": {
     "type": "string"
    }
   },
   "description": "Present only when this plan's byte allowance did not cover the object's actual size. Informational, not a refusal: the renewal above still happened, for exactly what was paid."
  },
  "plan": {
   "enum": [
    "small",
    "medium",
    "large",
    "year"
   ],
   "type": "string"
  },
  "payment": {
   "type": "object",
   "properties": {
    "asset": {
     "type": "string"
    },
    "payer": {
     "type": "string",
     "description": "The paying wallet's address."
    },
    "amount": {
     "type": "string",
     "description": "Atomic units of the settlement asset that were charged."
    },
    "network": {
     "type": "string"
    },
    "transaction": {
     "type": "string",
     "description": "On-chain settlement transaction hash."
    }
   }
  },
  "expiresAt": {
   "type": "integer",
   "description": "Unix ms the object is free again, after this renewal."
  },
  "previousExpiresAt": {
   "type": "integer",
   "description": "Unix ms the object would have expired before this renewal."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-exec-storage-object-renewal-900af2ca/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-exec.448c.org](https://www.zero.xyz/host/agent-exec.448c.org/llms.txt)