Upload a report

POST/api/upload

Uploads a report snapshot. Requires the reports:write scope. Reports are immutable — a new upload to an existing name produces a new code and version rather than altering an existing one. Limits: up to 100 files per request, 10 MB per decoded file, 20 MB total request body. Assets reference each other with relative paths; absolute src="/…" references and <base> are unsupported and reported in warnings.

Body Parameters

filesarray of objectsrequired

Non-empty. One entry must have path equal to index.html.

Show child attributes

pathstringrequired

Bare filename (no subdirectories). Exactly one entry must be index.html.

contentstringrequired

File contents. UTF-8 text, or base64 when encoding is base64.

encodingstring

Content encoding. Default "utf-8". One of utf-8, base64.

namestring

Group name. Re-uploading an existing name adds a version; a name owned by another account returns 409.

titlestring

Defaults to the document's <title> when omitted.

folderstring

Portal-only label, e.g. RD/2026/Q2. Never appears in URLs.

visibilitystring

Defaults to private. A public report is the one served from the content host. Default "private". One of public, private.

const res = await fetch("https://leafpage.cc/api/upload", {
  method: "POST",
  headers: {
    "Authorization": "Bearer lp_…",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "name": "quarterly-report",
    "visibility": "public",
    "files": [
      {
        "path": "index.html",
        "content": "<!doctype html><title>Q2</title><h1>Hello</h1>"
      }
    ]
  }),
});
const data = await res.json();

$ch = curl_init("https://leafpage.cc/api/upload");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer lp_…", "Content-Type: application/json"]);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{"name":"quarterly-report","visibility":"public","files":[{"path":"index.html","content":"<!doctype html><title>Q2</title><h1>Hello</h1>"}]}');
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

import requests

res = requests.post(
    "https://leafpage.cc/api/upload",
    headers={
        "Authorization": "Bearer lp_…",
        "Content-Type": "application/json",
    },
    json={
      "name": "quarterly-report",
      "visibility": "public",
      "files": [
        {
          "path": "index.html",
          "content": "<!doctype html><title>Q2</title><h1>Hello</h1>"
        }
      ]
    },
)
data = res.json()

require "net/http"
require "json"

uri = URI("https://leafpage.cc/api/upload")
req = Net::HTTP::Post.new(uri)
req["Authorization"] = "Bearer lp_…"
req["Content-Type"] = "application/json"
req.body = '{"name":"quarterly-report","visibility":"public","files":[{"path":"index.html","content":"<!doctype html><title>Q2</title><h1>Hello</h1>"}]}'
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
data = JSON.parse(res.body)

package main

import (
  "net/http"
  "strings"
)

func main() {
  body := strings.NewReader(`{"name":"quarterly-report","visibility":"public","files":[{"path":"index.html","content":"<!doctype html><title>Q2</title><h1>Hello</h1>"}]}`)
  req, _ := http.NewRequest("POST", "https://leafpage.cc/api/upload", body)
  req.Header.Set("Authorization", "Bearer lp_…")
  req.Header.Set("Content-Type", "application/json")
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
}

let client = reqwest::Client::new();
let res = client.post("https://leafpage.cc/api/upload")
    .header("Authorization", "Bearer lp_…")
    .header("Content-Type", "application/json")
    .body(r#"{"name":"quarterly-report","visibility":"public","files":[{"path":"index.html","content":"<!doctype html><title>Q2</title><h1>Hello</h1>"}]}"#)
    .send()
    .await?;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://leafpage.cc/api/upload"))
    .header("Authorization", "Bearer lp_…")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("""
{"name":"quarterly-report","visibility":"public","files":[{"path":"index.html","content":"<!doctype html><title>Q2</title><h1>Hello</h1>"}]}"""))
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

using var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://leafpage.cc/api/upload");
request.Headers.Add("Authorization", "Bearer lp_…");
request.Content = new StringContent("""{"name":"quarterly-report","visibility":"public","files":[{"path":"index.html","content":"<!doctype html><title>Q2</title><h1>Hello</h1>"}]}""", Encoding.UTF8, "application/json");
var response = await client.SendAsync(request);

curl -X POST "https://leafpage.cc/api/upload" \
  -H "Authorization: Bearer lp_…" \
  -H "Content-Type: application/json" \
  -d '{"name":"quarterly-report","visibility":"public","files":[{"path":"index.html","content":"<!doctype html><title>Q2</title><h1>Hello</h1>"}]}'

Response200

{
  "code": "a1b2c3d4e5f6g7h8",
  "url": "https://view.leafpage.cc/a1b2c3d4e5f6g7h8/",
  "owner": "acme",
  "visibility": "public",
  "created_at": "2026-06-27T00:00:00.000Z",
  "name": "quarterly-report"
}