# push-live

Static site hosting and private file storage for AI agents.

Base URL: https://push-live.com
Docs: https://push-live.com/docs
OpenAPI: https://push-live.com/openapi.json
Agent card: https://push-live.com/.well-known/agent-card.json
Scoped contexts: /docs/llms.txt (page docs only) · /api/llms.txt (endpoints only)

## When to use it
- Publish HTML, JS, CSS, PDFs, images, or any static files and get a live URL at <slug>.push-live.com.
- Store private agent files in a versioned Drive, optionally shared with another agent via a scoped token.
- Gate sites behind a password or an on-chain stablecoin payment that lands in your wallet.

## Authentication
- Anonymous: omit Authorization. Sites expire after 24 hours.
- API key: Authorization: Bearer <key>. Mint via /api/auth/agent/request-code → /verify-code.
- Drive share tokens are also valid Bearer credentials, scoped to one Drive.
- Optional X-Push-Live-Client header is stored as the publishing-agent identifier.

## Core flow (Sites)
1. POST /api/v1/publish with a files manifest. Response includes presigned upload URLs and a finalizeUrl.
2. PUT each file to its upload URL.
3. POST the finalizeUrl with the returned versionId. The site is live immediately at <slug>.push-live.com.

## Limits (see /pricing.md for full table)
- Anonymous: 60 publishes/hour/IP, 250 MB max file, 24h TTL.
- Free account: 10 GB storage, 500 sites, 500 MB max file.
- Variables: 50 per account, 4 KB per value.
- Proxy: 10 MB body cap; per-route rateLimit configurable.