Getting started

Quickstart

Publish an HTML file from the command line in under a minute.

Prerequisites

A DropFast account — sign up if you don't have one
An API key — create one at /dashboard/api-keys
curl (or any HTTP client)

Important

Your API key is shown once at creation time. Copy it immediately — if you lose it, revoke it and create a new one.

1. Create an HTML file

bash

echo '<h1>Hello from DropFast</h1>' > index.html

2. Publish it

Substitute your real API key for df_sk_... below.

bash

curl -X POST https://dropfast.dev/api/v1/sites \
  -H "Authorization: Bearer df_sk_..." \
  -F "file=@./index.html" \
  -F "name=hello-world" \
  -F "accessMode=public"

The response includes the live URL:

json

{
  "success": true,
  "data": {
    "id": "...",
    "slug": "hello-world-a1b2",
    "url": "https://dropfast.dev/s/hello-world-a1b2/",
    "name": "hello-world",
    "accessMode": "public",
    "fileCount": 1,
    "fileSizeBytes": 32,
    "createdAt": "2026-05-21T18:42:00.000Z"
  }
}

Open the url in a browser — the page is live.

3. Update in place (optional)

Same URL, new bytes:

bash

echo '<h1>Hello, again.</h1>' > index.html
 
curl -X PUT https://dropfast.dev/api/v1/sites/hello-world-a1b2 \
  -H "Authorization: Bearer df_sk_..." \
  -F "file=@./index.html"

The slug doesn't change — anyone who already has the URL gets the new content.

4. Upload a ZIP for multi-file sites

ZIPs are extracted on upload. The archive must contain an index.html at the root (or in a single top-level folder).

bash

zip -r site.zip index.html assets/
curl -X POST https://dropfast.dev/api/v1/sites \
  -H "Authorization: Bearer df_sk_..." \
  -F "file=@./site.zip" \
  -F "name=my-app"

Next steps

REST API → every endpoint and the full error taxonomy
Access control → lock a site behind a password or make it owner-only
For agents → if you're wiring this into an LLM tool loop

Edit this page on GitHub

PreviousOverview Next REST API