Replace one file

PUT

/pages/{slug}/files/{path}

Replace the bytes of a single file, keeping the page's URL unchanged. The
body is the raw file content. If the path does not yet exist it is added —
and adding a second path to a single HTML page (kind: html) promotes it to
a hosted site exactly as the batch endpoint above describes, reporting
becameSite (and displayModeReset) in the response.

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

Body Params application/octet-streamRequired

Not configured

Responses

🟢200OK

application/json

The file was written; the refreshed file list is returned.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠409

🟠413

🟠422Parameter Error

🟠429

🔴500Server Error

🔴503Service Unavailable

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

Apply a batch of file changes

Delete one file