Getting started

Quickstart

Go from an HTML file to a shareable URL with a single request. No account or API key needed.

On this page

Deploy your first drop

Take an HTML file from your computer — a report, a prototype, a one-pager — and send it to /deploy.

bash

curl -X POST https://ship.page/deploy \
  -H "Content-Type: text/html" \
  --data-binary @index.html

Run this from the folder containing index.html, or replace it with your file’s path.

Get your live URL

The response contains your live URL. Share the url value; your page is ready to open.

json200 OK

{
  "slug": "vast-juice-c2dse",
  "url": "https://vast-juice-c2dse.shipped.run/",
  "files": ["index.html"],
  "plan": "free",
  "password_protected": false,
  "expires_at": "2026-06-17T18:00:00.000Z",
  "claim_token": "spc_7xk3m9q2vj8n4p1w6z5y0r2t"
}

Keep your claim token.

Anonymous deploys return claim_token exactly once. Save it to claim the drop into an account later.

Know your drop

Your own subdomain: Every drop mounts at /. Absolute paths like /app.js and /styles.css resolve as-is — no base-path rewrites.
A link to share: Slugs carry ~47 bits of entropy. Anyone with the link can view an unprotected drop; viewers don’t need an account.
Room to keep it: Anonymous drops last 30 days. A free account gives you 90 days; subscribed drops don’t expire by default. Shorten the lifetime with ?ttl=. About expiry

Keep going

Shipping more than one file? The same endpoint accepts ZIP archives and JSON files maps.

API referenceDeploy a dropRequest formats, headers, and responses.

Last updated Jun 12, 2026