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
402and nothing changes. -
Expired sites are removed by a scheduled sweep, not at the exact second — don't rely
on
x-c71-ttlfor anything time-critical. To remove an expiry later, callmanagewithset_ttland"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:
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.