Lava Pages - Lava Documentation

Lava’s first-party page hosting API. Post a single HTML document and get back a public URL at lava.so/p/ 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 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

SDK
cURL

const data = await lava.gateway('https://api.lava.so/v1/pages', {
  body: {
"html": "<!doctype html><html><body><h1>Hello</h1></body></html>"
},
});

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":"<!doctype html><html><body><h1>Hello</h1></body></html>"}'

Next Steps

All Providers

Browse all supported AI providers

Forward Proxy

Learn how to construct proxy URLs and authenticate requests

⌘I

​Endpoints

​Create a public HTML page hosted at lava.so/p/{id}. Body: { html: string } (max 1MB, scripts blocked by CSP). Returns { id, url }.

​Next Steps

All Providers

Forward Proxy

Endpoints

Create a public HTML page hosted at lava.so/p/{id}. Body: { html: string } (max 1MB, scripts blocked by CSP). Returns { id, url }.

Next Steps