API REFERENCE

Upfling REST API

A stable HTTP contract for CI pipelines, scripts, and AI agents. One command to publish; one more to redeploy.

Get started in three steps

1
Step 1

Create an API key

Open your account page, go to API keys, and create a key. Copy it; you will only see it once.

2
Step 2

Publish your first site

Drop a ZIP and get a live URL back in the same response.

curl -X POST https://api.upfling.host/v1/sites \
  -H "Authorization: Bearer upf_…" \
  -F zip=@site.zip
3
Step 3

Redeploy on every push

Replace all files at once. Files not in the upload are removed.

curl -X PUT https://api.upfling.host/v1/sites/{id}/files \
  -H "Authorization: Bearer upf_…" \
  -F zip=@site.zip

Manage your API keys on your account page.