# Halowerk File Vault

> Halowerk File Vault is a paid API for AI agents from agent.halowerk.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-09-15).

Stores a base64-encoded file (up to 25 MB) for a specified duration (up to 7 days) and returns a download URL with a 32-byte token, supporting configurable download limits and no account required.

## Facts

- Endpoint: POST https://agent.halowerk.com/v1/file-vault
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 1
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-file-vault-31b5cd7e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WEw2Pn-68ODNn05Zw2CDS

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 halowerk-file-vault-31b5cd7e -d '<json body>'
```

Example prompt: Store this base64-encoded PDF for me for 2 days, allow up to 3 downloads, and give me the link — it's about 1.5 MB.

## When to prefer this

Choose this endpoint when an agent needs to pass a file to another agent or webhook via URL without standing up its own storage, when the file must expire automatically, when a download limit is needed for access control, and when no account or long-term infrastructure is required. Ideal for ephemeral agent-to-agent payloads and one-shot file deliveries in agentic pipelines.

## Known failure modes

- File exceeds 25 MB limit — request rejected
- TTL exceeds 7-day maximum — capped or rejected
- Download limit reached — subsequent fetches return 404 or 410
- Invalid or malformed base64 input — parse error returned
- Payment insufficient for declared file size — transaction rejected
- File not found on status/delete if token is invalid or already expired

## How this service works

Takes a base64 file up to 25 MB and stores it for as long as you say, at most seven days. You get a download URL carrying a 32-byte token; whoever holds the link can fetch the file once or up to a limit you set, with no payment and no account. Price is 0.004 USDC per started megabyte, quoted before payment from the size you declare. Actions: store, status, delete.

## Output

A download URL containing a 32-byte access token that the holder can use to fetch the file. The response also includes the storage status, expiry time, and the remaining allowed download count. The price is quoted upfront based on declared file size at 0.004 USDC per started megabyte.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-file-vault-31b5cd7e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent.halowerk.com](https://www.zero.xyz/host/agent.halowerk.com/llms.txt)