List a hosted site's files

GET

/pages/{slug}/files

The individual files inside a page that HAS files — a hosted site
(kind: site), or a single HTML page (kind: html), which is a one-file
site with the same manifest shape — listed with their sizes and content
types. Every other kind stores one opaque object with no addressable paths:
a downloadable ZIP has no file list and returns 400.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Responses

🟢200OK

application/json

The project's files.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠429

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://upload.tf/api/v1/pages/mysite/files' \
--header 'x-api-key: <api-key>'

Response Example

200 - Example 1

{
    "success": true,
    "data": {
        "files": [
            {
                "path": "assets/app.js",
                "sizeBytes": 88134,
                "contentType": "text/javascript; charset=utf-8",
                "isEntry": false
            }
        ],
        "fileCount": 12,
        "totalBytes": 1069547,
        "maxFiles": 200,
        "maxFileBytes": 26214400,
        "maxTotalBytes": 5368709120,
        "becameSite": false,
        "displayModeReset": false
    }
}

Modified at 2026-08-24 23:59:03

Unzip & host a page

Apply a batch of file changes