Update a Site - SimpleHost

Update an Existing Site

Publish a new version of an existing site. Uses hash deduplication — files with matching hashes are copied server-side and don’t need to be re-uploaded.

PUT /api/v1/publish/:slug

Path Parameters

string

required

The site slug to update (e.g., bright-canvas-a7k2).

Headers

Header	Required	Description
`Content-Type`	Yes	`application/json`
`Authorization`	Yes	`Bearer sh_live_...`

Request Body

Same as Create a Site. The files array contains the complete file manifest for the new version.

array

required

Complete file manifest for the new version. Include all files, not just changed ones.

Example

curl -X PUT https://simplehost.dev/api/v1/publish/bright-canvas-a7k2 \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sh_live_your_key_here" \
  -d '{
    "files": [
      {
        "path": "index.html",
        "size": 2048,
        "contentType": "text/html",
        "hash": "newsha256hash64charslong..."
      },
      {
        "path": "style.css",
        "size": 512,
        "contentType": "text/css",
        "hash": "f6e5d4c3b2a1f6e5d4c3b2a1f6e5d4c3b2a1f6e5d4c3b2a1f6e5d4c3b2a1f6e5"
      }
    ]
  }'

Response (200)

{
  "slug": "bright-canvas-a7k2",
  "siteUrl": "https://bright-canvas-a7k2.simplehost.dev/",
  "upload": {
    "versionId": "01jm4new789ghi012",
    "uploads": [
      {
        "path": "index.html",
        "method": "PUT",
        "url": "https://simplehost.dev/api/v1/_upload/...",
        "headers": { "Content-Type": "text/html" }
      }
    ],
    "skipped": [
      {
        "path": "style.css",
        "reason": "hash_match"
      }
    ],
    "finalizeUrl": "https://simplehost.dev/api/v1/publish/bright-canvas-a7k2/finalize",
    "expiresInSeconds": 3600
  }
}

How Deduplication Works

Include the hash field (SHA-256) for each file in the manifest
The API compares each hash against the previous version’s files
Files with matching hashes appear in the skipped array — they are copied server-side
Only files in the uploads array need to be uploaded

Always include hashes when updating. Without hashes, every file is treated as new and must be re-uploaded.

After uploading the non-skipped files, call Finalize with the new versionId.

​Update an Existing Site

​Path Parameters

​Headers

​Request Body

​Example

​Response (200)

​How Deduplication Works

Update an Existing Site

Path Parameters

Headers

Request Body

Example

Response (200)

How Deduplication Works