> ## Documentation Index
> Fetch the complete documentation index at: https://lava.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Lava Pages
> Lava's first-party page hosting API.
Lava's first-party page hosting API. Post a single HTML document and get back a public URL at lava.so/p/{id} that anyone can open in a browser. Designed for agent-generated artifacts — research summaries, dashboards, reports, share-links — that the agent wants the user to view as a real page rather than parse from a tool result. Static HTML only (no JavaScript), 1MB max, no expiry.
1 endpoint available through Lava's AI Gateway. See the [Lava Pages API docs](https://www.lava.so/docs) for full documentation.
Supports both **managed** (Lava's API keys) and **unmanaged** (bring your own credentials) mode.
## Endpoints
### Create a public HTML page hosted at lava.so/p/\{id}. Body: \{ html: string } (max 1MB, scripts blocked by CSP). Returns \{ id, url }.
**POST** `https://api.lava.so/v1/pages` — \$0.03 / request
```typescript theme={null}
const data = await lava.gateway('https://api.lava.so/v1/pages', {
body: {
"html": "Hello
"
},
});
```
```bash theme={null}
curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.lava.so%2Fv1%2Fpages" \
-H "Authorization: Bearer $LAVA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"html":"Hello
"}'
```
## Next Steps
Browse all supported AI providers
Learn how to construct proxy URLs and authenticate requests