cloud71
Docs

API reference

Every cloud71 action is a plain HTTPS call authenticated with a bearer token — so your own agent, a scheduled job, or any tool that can make an HTTP request can publish and manage sites. The MCP connector for Claude, ChatGPT, and coding agents is built on these same endpoints.

Base URL

https://app.cloud71.host

Authenticate with Authorization: Bearer c71_…. Create a token at /dashboard/tokens — you'll see it once, so store it as a secret in your agent's or job's environment, never in a prompt or a repository.

Publish in one call

Copy-paste recipes for agents, cron jobs, and CI. Each returns JSON with the live url — hand it to the next step of your workflow.

Publish a single page

No x-c71-site, so cloud71 creates a new site with a random cli-… name.

curl -X POST https://app.cloud71.host/api/cli/deploy \
  -H "Authorization: Bearer $C71_TOKEN" \
  -H "Content-Type: application/octet-stream" \
  -H "x-c71-filename: index.html" \
  --data-binary @index.html

Update the same site on every run

Name the site and each deploy replaces its content — the link never changes. Ideal for a daily report or digest.

curl -X POST https://app.cloud71.host/api/cli/deploy \
  -H "Authorization: Bearer $C71_TOKEN" \
  -H "Content-Type: application/octet-stream" \
  -H "x-c71-filename: digest.html" \
  -H "x-c71-site: daily-digest" \
  -H "x-c71-title: Daily digest" \
  -H "x-c71-tags: reports, internal" \
  --data-binary @digest.html

A private link that expires

Password-protected and taken down after 7 days (604800 seconds). The password needs Starter or above.

curl -X POST https://app.cloud71.host/api/cli/deploy \
  -H "Authorization: Bearer $C71_TOKEN" \
  -H "Content-Type: application/octet-stream" \
  -H "x-c71-filename: report.html" \
  -H "x-c71-password: $REPORT_PASSWORD" \
  -H "x-c71-ttl: 604800" \
  --data-binary @report.html

Publish a whole folder

Zip the folder's contents (so index.html is at the top of the archive) and send the ZIP.

(cd dist && zip -qr ../site.zip .)

curl -X POST https://app.cloud71.host/api/cli/deploy \
  -H "Authorization: Bearer $C71_TOKEN" \
  -H "Content-Type: application/octet-stream" \
  -H "x-c71-filename: site.zip" \
  -H "x-c71-site: acme-launch" \
  --data-binary @site.zip

Deploy headers

POST /api/cli/deploy takes the file as the raw request body and everything else as headers. x-c71-filename and x-c71-site can also be sent as ?filename= and ?site= query parameters.

x-c71-filename file name

The name of the file you're sending, with its extension. .zip is unpacked into a site; .html or .htm becomes the page; anything else (PDF, image, video, Office doc) is served behind a built-in viewer. Defaults to site.zip.

All plans

x-c71-site site name

The site to update or create (3–63 lowercase letters, numbers, and hyphens). If you own it, the deploy replaces its content in place; if it doesn't exist yet, it's created. Omit it for a new site with a random cli-… name.

All plans · new sites count toward your site limit

x-c71-title text

A display title for the site, shown in your dashboard and in /api/cli/sites.

All plans

x-c71-tags a, b, c

Comma-separated tags. Blank entries and duplicates are dropped; an empty value clears the tags.

All plans

x-c71-ttl seconds | ISO date

When the link should expire: a number of seconds from now (86400 = one day) or an ISO 8601 date such as 2026-12-31T23:59:00Z. Anything else returns 400.

All plans

x-c71-url-mode subdomain | path

Which address the response's url uses: subdomain (name.cloud71.site, the default) or path (cloud71.site/<id>). Both addresses work either way.

All plans

x-c71-password password

Puts the site behind a password gate as it publishes.

Starter and up · 402 on Free

x-c71-lead-capture true | false

true turns on the opt-in email form; any other value turns it off. Leave the header out to keep the current setting.

Starter and up to turn on · 402 on Free

  • Title, tags, expiry, and URL mode apply when a site is created and when it's updated. Headers you leave out leave the existing setting alone.
  • Password and lead capture are checked before anything is published: on a plan without the feature, the request returns 402 and nothing changes.
  • Expired sites are removed by a scheduled sweep, not at the exact second — don't rely on x-c71-ttl for anything time-critical. To remove an expiry later, call manage with set_ttl and "expiresAt": null.
  • Updating a site you already own never counts as a new site, so the free plan can keep redeploying its one site as often as it likes.

Endpoints

GET /api/cli/whoami

Verify a token and return the account it belongs to.

curl https://app.cloud71.host/api/cli/whoami \
  -H "Authorization: Bearer c71_…"

# 200 OK
{ "email": "[email protected]", "plan": "pro" }

GET /api/cli/sites

List your sites, most recently updated first. url uses the custom domain when one is attached; liveUrl uses it only once its SSL certificate is active.

curl https://app.cloud71.host/api/cli/sites \
  -H "Authorization: Bearer c71_…"

# 200 OK
{ "sites": [
  { "subdomain": "daily-digest",
    "url": "https://reports.example.com",
    "liveUrl": "https://reports.example.com",
    "subdomainUrl": "https://reports.example.com",
    "pathUrl": "https://cloud71.site/aB3xK9pQ",
    "pathId": "aB3xK9pQ",
    "title": "Daily digest",
    "tags": ["reports", "internal"],
    "customDomain": "reports.example.com",
    "sslStatus": "active",
    "isProtected": true,
    "leadCaptureEnabled": false,
    "visitsThisMonth": 128,
    "expiresAt": null,
    "status": "active",
    "updatedAt": "2026-10-27T09:00:00.000Z" }
] }

POST /api/cli/deploy

Publish a single file or a zipped folder. Send the raw bytes as the request body and describe them with the headers above. The URL comes back right away; files are unpacked in the background and are usually live within seconds.

curl -X POST https://app.cloud71.host/api/cli/deploy \
  -H "Authorization: Bearer c71_…" \
  -H "Content-Type: application/octet-stream" \
  -H "x-c71-filename: site.zip" \
  -H "x-c71-site: daily-digest" \
  --data-binary @site.zip

# 200 OK
{ "ok": true,
  "siteId": "…",
  "subdomain": "daily-digest",
  "url": "https://daily-digest.cloud71.site",
  "subdomainUrl": "https://daily-digest.cloud71.site",
  "pathUrl": "https://cloud71.site/aB3xK9pQ" }

GET /api/cli/read

Inspect a site by name. Without path, returns the file list; with path, returns that file's text contents — so an agent can read, edit, then redeploy.

# List files
curl "https://app.cloud71.host/api/cli/read?site=daily-digest" \
  -H "Authorization: Bearer c71_…"
# { "site": "daily-digest", "files": ["index.html", "style.css"] }

# Read one file
curl "https://app.cloud71.host/api/cli/read?site=daily-digest&path=index.html" \
  -H "Authorization: Bearer c71_…"
# { "site": "…", "path": "index.html", "content": "…" }

GET /api/cli/download

Download a site's current files as a .zip — handy for backups or for editing a whole site locally.

curl "https://app.cloud71.host/api/cli/download?site=daily-digest" \
  -H "Authorization: Bearer c71_…" \
  -o daily-digest.zip

POST /api/cli/manage

Change a site. Send JSON with the site name and an action: settings, rename, set_ttl, set_tags, set_domain, domain_status, remove_domain, rollback, or delete. Passwords, lead capture, SEO, and custom domains need Starter or above (custom domains count toward your plan's limit: 5 on Starter, unlimited on Pro and Business); delete is owner-only.

curl -X POST https://app.cloud71.host/api/cli/manage \
  -H "Authorization: Bearer c71_…" \
  -H "Content-Type: application/json" \
  -d '{ "site": "daily-digest", "action": "rename", "title": "Daily digest" }'

# Settings — send any of these; null clears a value
-d '{ "site": "daily-digest", "action": "settings",
      "password": "s3cret", "leadCapture": true,
      "expiresAt": 1798761600000,
      "seoTitle": "Daily digest", "seoDescription": "…" }'

# Set an expiry (ms since epoch) — or null to remove it
-d '{ "site": "daily-digest", "action": "set_ttl", "expiresAt": 1798761600000 }'

# Replace the tags
-d '{ "site": "daily-digest", "action": "set_tags", "tags": ["reports"] }'

# Attach a custom domain — returns cnameTarget + dnsRecords to add
-d '{ "site": "daily-digest", "action": "set_domain", "domain": "reports.example.com" }'

# Check whether the domain's SSL is live, or detach it
-d '{ "site": "daily-digest", "action": "domain_status" }'
-d '{ "site": "daily-digest", "action": "remove_domain" }'

# Roll back to a saved version (the live one is saved first)
-d '{ "site": "daily-digest", "action": "rollback", "version": 3 }'

# Delete
-d '{ "site": "daily-digest", "action": "delete" }'

GET /api/cli/stats

Visits and unique visitors by month (newest first), top referrers from the last 30 days, and lead counts.

curl "https://app.cloud71.host/api/cli/stats?site=daily-digest" \
  -H "Authorization: Bearer c71_…"

# 200 OK
{ "site": "daily-digest",
  "url": "https://reports.example.com",
  "thisMonth": { "visits": 128, "uniqueVisitors": 91 },
  "visitLimit": 100000,
  "months": [{ "yearMonth": "2026-10", "visits": 128,
               "uniqueVisitors": 91, "bandwidthBytes": 5242880 }],
  "topReferrers": [{ "referrer": "https://www.linkedin.com/", "visits": 40 }],
  "leads": { "total": 12, "last30Days": 5 } }

GET /api/cli/versions

A site's saved versions, newest first. Every republish keeps the previous version (the last 5); restore one with the rollback action.

curl "https://app.cloud71.host/api/cli/versions?site=daily-digest" \
  -H "Authorization: Bearer c71_…"

# 200 OK
{ "site": "daily-digest",
  "versions": [{ "version": 3, "fileCount": 4, "bytes": 81920,
                 "createdAt": "2026-10-28T09:00:00.000Z",
                 "sourceType": "zip" }] }

Token scopes

Tokens you create in the dashboard can call every endpoint. Tokens issued to an OAuth client carry scopes: deploy for /deploy, sites:read for /sites, /read, /download, /stats, and /versions, and sites:write for /manage. A missing scope returns 403. Tokens only reach these endpoints — never billing or account settings.

Errors

Errors return a JSON body of the shape { "error": "…" } with an appropriate status:

400 Bad request — an empty deploy body, an invalid x-c71-ttl or site name, or a missing field.
401 Missing or invalid bearer token (plain-text body).
402 Plan limit or paid feature. The body includes { error, trigger }: site_cap, storage_cap, custom_domain_cap, or feature_paywall (with the feature name).
403 The token is missing the scope this endpoint needs, or only the owner can delete the site.
404 Site or file not found.
409 That site name belongs to another account.

Plan limits

API calls count against the same limits as the dashboard. Hitting one returns 402 with a trigger you can surface to the user. A single ZIP can expand to at most 100 MB, and every deploy counts toward your plan's storage.

Plan Sites Storage Visits / site / mo
Free 1 100 MB 5,000
Starter 5 1 GB 10,000
Pro Unlimited 25 GB 100,000
Business Unlimited 250 GB Unlimited

See pricing for everything each plan includes.

Connecting an AI assistant instead?

Claude, ChatGPT, Claude Code, Cursor, and other MCP clients don't need a token: add the MCP connector, sign in with OAuth, and ask them to publish. Same account, same sites.