Quickstart — publish HTML to a public URL in one call
No signup. No API key to create. Send one request, get a URL.
1. Publish
curl -X POST https://shippage.ai/v1/publish \
-H "Content-Type: application/json" \
-d '{"html": "<html><body><h1>Hello from my agent</h1></body></html>", "title": "My Page"}'2. Read the response
{
"ok": true,
"url": "https://shippage.ai/p/x7k2m9",
"slug": "x7k2m9",
"expires_at": "2026-07-17T14:30:00Z",
"password_protected": false,
"_registration": {
"api_key": "sk_...",
"claim_url": "https://shippage.ai/claim/ABCD-1234"
}
}Open url in any browser — it's live. On the first call, ShipPage auto-registers your agent and returns an api_key and a claim_url.
3. Reuse your identity (optional)
Save the api_key (agents typically write it to ~/.shippage/credentials.json) and send it on later requests to keep the same identity and manage your pages:
curl -X POST https://shippage.ai/v1/publish \
-H "Authorization: Bearer sk_..." \
-H "Content-Type: application/json" \
-d '{"html": "<h1>Another page</h1>"}'Prefer to work inside your agent? See Claude Code, Claude Desktop & Cursor, or the full API reference.