PageDrop API Documentation

curl -X POST "https://pagedrop.dev/api/v1/sites" \
  -H "Content-Type: application/json" \
  -d '{"html": "<h1>Hello World</h1><p>Deployed with PageDrop!</p>"}'

curl -X POST "https://pagedrop.dev/api/v1/sites" \
  -H "Content-Type: application/json" \
  -d '{
    "markdown": "# Hello World\n\nThis is **bold** and this is `code`.\n\n## Features\n\n- Auto-styled HTML\n- Dark/light mode\n- Responsive design",
    "slug": "my-readme"
  }'

curl -X POST "https://pagedrop.dev/api/v1/sites" \
  -H "Content-Type: application/json" \
  -d '{
    "html": "<h1>My Demo</h1>",
    "ogTitle": "My Demo Page",
    "ogDescription": "Check out this awesome demo hosted on PageDrop",
    "ogImage": "https://example.com/preview.png"
  }'

curl -X POST "https://pagedrop.dev/api/v1/sites" \
  -F "file=@document.pdf"

curl -X POST "https://pagedrop.dev/api/v1/sites" \
  -F "file=@my-project.zip"

{
  "status": "success",
  "data": {
    "siteId": "a1b2c3d4",
    "url": "https://pagedrop.dev/s/a1b2c3d4",
    "deleteToken": "dlt_e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8",
    "expiresAt": null,
    "ttlDays": null,
    "files": ["index.html"],
    "totalSizeBytes": 1234,
    "viewCount": 0,
    "createdAt": "2026-02-17T12:00:00.000Z",
    "passwordProtected": false
  }
}

curl -X PUT "https://pagedrop.dev/api/v1/sites/my-project" \
  -H "Content-Type: application/json" \
  -H "X-Delete-Token: dlt_your_token_here" \
  -d '{"html": "<h1>Updated Content</h1>"}'

{
  "status": "success",
  "data": {
    "siteId": "my-project",
    "url": "https://pagedrop.dev/s/my-project",
    "expiresAt": null,
    "files": ["index.html"],
    "totalSizeBytes": 512,
    "updatedAt": "2026-02-27T12:00:00.000Z"
  }
}

{
  "status": "success",
  "data": {
    "siteId": "a1b2c3d4",
    "url": "https://pagedrop.dev/s/a1b2c3d4",
    "createdAt": "2026-02-17T12:00:00.000Z",
    "expiresAt": null,
    "fileCount": 1,
    "totalSizeBytes": 1234,
    "viewCount": 42,
    "files": ["index.html"]
  }
}

curl -X DELETE "https://pagedrop.dev/api/v1/sites/a1b2c3d4" \
  -H "X-Delete-Token: dlt_e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8"

{
  "status": "success",
  "message": "Site a1b2c3d4 has been deleted"
}

curl -X POST "https://pagedrop.dev/api/v1/sites/batch" \
  -H "Content-Type: application/json" \
  -d '{
    "sites": [
      { "html": "<h1>Page One</h1>", "slug": "page-one", "ttl": "7d" },
      { "markdown": "# Page Two\nHello world", "title": "My Doc" },
      { "html": "<h1>Page Three</h1>" }
    ]
  }'

{
  "status": "success",
  "data": {
    "created": [
      {
        "siteId": "page-one",
        "url": "https://pagedrop.dev/s/page-one",
        "deleteToken": "dlt_abc123...",
        "expiresAt": "2026-03-20T12:00:00.000Z",
        "files": ["index.html"],
        "totalSizeBytes": 22
      },
      {
        "siteId": "a1b2c3d4",
        "url": "https://pagedrop.dev/s/a1b2c3d4",
        "deleteToken": "dlt_def456...",
        "expiresAt": null,
        "files": ["index.html"],
        "totalSizeBytes": 150
      },
      {
        "siteId": "e5f6g7h8",
        "url": "https://pagedrop.dev/s/e5f6g7h8",
        "deleteToken": "dlt_ghi789...",
        "expiresAt": null,
        "files": ["index.html"],
        "totalSizeBytes": 24
      }
    ],
    "failed": [],
    "totalCreated": 3,
    "totalFailed": 0
  }
}

curl -X POST "https://pagedrop.dev/api/v1/sites/batch/delete" \
  -H "Content-Type: application/json" \
  -d '{
    "sites": [
      { "siteId": "abc123", "deleteToken": "dlt_token1..." },
      { "siteId": "def456", "deleteToken": "dlt_token2..." }
    ]
  }'

{
  "status": "success",
  "data": {
    "deleted": ["abc123"],
    "failed": [
      { "siteId": "def456", "error": "Invalid delete token" }
    ],
    "totalDeleted": 1,
    "totalFailed": 1
  }
}

curl -X POST "https://pagedrop.dev/api/v1/sites/abc123/fork" \
  -H "Content-Type: application/json" \
  -d '{ "slug": "my-remix" }'

{
  "status": "success",
  "data": {
    "siteId": "my-remix",
    "url": "https://pagedrop.dev/s/my-remix",
    "deleteToken": "dlt_...",
    "expiresAt": null,
    "files": ["index.html"],
    "totalSizeBytes": 42,
    "forkedFrom": "abc123",
    "createdAt": "2026-03-17T..."
  }
}

curl "https://pagedrop.dev/api/v1/sites/a1b2c3d4/analytics" \
  -H "X-Delete-Token: dlt_e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8"

{
  "status": "success",
  "data": {
    "siteId": "a1b2c3d4",
    "viewCount": 42,
    "recentViews": [
      { "timestamp": "2026-03-11T14:30:00.000Z", "referrer": "https://twitter.com/someone/status/123" },
      { "timestamp": "2026-03-11T14:25:00.000Z", "referrer": null },
      { "timestamp": "2026-03-11T13:10:00.000Z", "referrer": "https://google.com" }
    ],
    "dailyViews": {
      "2026-03-11": 15,
      "2026-03-10": 12,
      "2026-03-09": 15
    },
    "topReferrers": [
      { "referrer": "(direct)", "count": 20 },
      { "referrer": "https://twitter.com/someone/status/123", "count": 12 },
      { "referrer": "https://google.com", "count": 10 }
    ]
  }
}

{
  "status": "success",
  "data": {
    "siteId": "a1b2c3d4",
    "files": [
      { "path": "index.html", "contentType": "text/html; charset=utf-8" },
      { "path": "style.css", "contentType": "text/css" },
      { "path": "app.js", "contentType": "application/javascript" }
    ],
    "totalSizeBytes": 8192
  }
}

{
  "error": "Validation failed",
  "message": "Request body must include 'html' field or upload a file"
}

# Deploy raw HTML
curl -X POST "https://pagedrop.dev/api/v1/sites" \
  -H "Content-Type: application/json" \
  -d '{"html": "<h1>Hello!</h1>"}'

# Upload a PDF file
curl -X POST "https://pagedrop.dev/api/v1/sites" \
  -F "file=@document.pdf"

# Upload a ZIP project
curl -X POST "https://pagedrop.dev/api/v1/sites" \
  -F "file=@my-project.zip"

# Get site metadata
curl "https://pagedrop.dev/api/v1/sites/a1b2c3d4"

# List files in a site
curl "https://pagedrop.dev/api/v1/sites/a1b2c3d4/files"

# Delete a site
curl -X DELETE "https://pagedrop.dev/api/v1/sites/a1b2c3d4" \
  -H "X-Delete-Token: dlt_YOUR_TOKEN_HERE"

// Deploy HTML
const response = await fetch("https://pagedrop.dev/api/v1/sites", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    html: "<h1>Hello World</h1><p>Deployed with PageDrop</p>"
  })
});

const { data } = await response.json();
console.log(`Live at: ${data.url}`);
console.log(`Expires: ${data.expiresAt ?? "Never"}`);
console.log(`Delete token: ${data.deleteToken}`); // Save this!

// Get site metadata
const meta = await fetch(`https://pagedrop.dev/api/v1/sites/${data.siteId}`);
console.log(await meta.json());

// Upload a PDF file
const pdfForm = new FormData();
pdfForm.append("file", pdfBlob, "document.pdf");
const pdfUpload = await fetch("https://pagedrop.dev/api/v1/sites", {
  method: "POST",
  body: pdfForm
});
console.log(await pdfUpload.json());

// Upload a ZIP file
const formData = new FormData();
formData.append("file", zipFileBlob, "project.zip");
const upload = await fetch("https://pagedrop.dev/api/v1/sites", {
  method: "POST",
  body: formData
});
console.log(await upload.json());

// Delete a site
await fetch(`https://pagedrop.dev/api/v1/sites/${data.siteId}`, {
  method: "DELETE",
  headers: { "X-Delete-Token": data.deleteToken }
});

import requests

# Deploy HTML
response = requests.post(
    "https://pagedrop.dev/api/v1/sites",
    json={"html": "<h1>Hello World</h1><p>Deployed with PageDrop</p>"}
)
result = response.json()
site = result["data"]
print(f"Live at: {site['url']}")
print(f"Expires: {site['expiresAt'] or 'Never'}")
print(f"Delete token: {site['deleteToken']}")  # Save this!

# Get site metadata
meta = requests.get(f"https://pagedrop.dev/api/v1/sites/{site['siteId']}")
print(meta.json())

# Upload a PDF file
with open("document.pdf", "rb") as f:
    pdf_upload = requests.post(
        "https://pagedrop.dev/api/v1/sites",
        files={"file": ("document.pdf", f, "application/pdf")}
    )
    print(pdf_upload.json())

# Upload a ZIP file
with open("my-project.zip", "rb") as f:
    upload = requests.post(
        "https://pagedrop.dev/api/v1/sites",
        files={"file": ("project.zip", f, "application/zip")}
    )
    print(upload.json())

# Delete a site
requests.delete(
    f"https://pagedrop.dev/api/v1/sites/{site['siteId']}",
    headers={"X-Delete-Token": site["deleteToken"]}
)

{
  "mcpServers": {
    "pagedrop": {
      "command": "npx",
      "args": ["-y", "pagedrop-mcp"]
    }
  }
}