SoftSolzSoftSolz
HomeAPI GuideAPI ReferenceWidget Tester
Launchpad

Write, patch or delete files of the client website

Up to 40 changes applied together after a saved version is taken. Every file is safety checked (422 unsafe_site_content names the file and the reason), index.html can never be removed (422 index_required), uploaded images cannot be overwritten with text (422 not_editable) and a website holds at most 60 files (422 too_many_files). Send expected_version from your last read; 409 STALE_VERSION means the website changed since. 409 site_busy means another change is in progress, so retry in a few seconds. Changes show on the live website after POST /clients/{id}/publish.

POSThttps://app.softsolz.uk/api/v1/services/launchpad/clients/{id}/site/files/apply

Recent Requests

Kept only in this browser
TimeStatusTook
Send a request with Try it to see it here.

Path Params

idstringrequired

Headers

Authorizationstringrequired

Bearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.

Idempotency-Keystring

Optional idempotency key for safe retries.

Body Params

operationsarray of objectsrequired

Changes to apply, in order.

expected_versionstring

content_version from your last read of site/files. Refused with 409 STALE_VERSION when the website changed since.

labelstring

Short description of the change, shown in the website history.

Response

Response Body

changedarray of stringsPaths written.
deletedarray of stringsPaths removed.
patch_failuresarray of stringsPatches that were not applied because their find text matched no place or more than one. Read the file again and send a corrected patch or a full write.
snapshot_idstringSaved version taken before the change.
content_versionstring | nullNew version to send as expected_version next time.
issuesarray of objectsQuality problems found in the changed files. Fix every error before publishing.

Request

curl --request POST \
--url https://app.softsolz.uk/api/v1/services/launchpad/clients/{id}/site/files/apply \
--header 'Authorization: Bearer sk_live_your_key' \
--header 'Content-Type: application/json' \
--data '{
"operations": [
{
"op": "write",
"path": "opening-hours.html",
"content": "<!doctype html>\n<html lang=\"en-GB\">\n<head>\n<meta charset=\"utf-8\">\n<meta name=\"viewport\" content=\"width=device-width, initial-scale=1\">\n<title>Opening hours | Northwind Bistro</title>\n<meta name=\"description\" content=\"When Northwind Bistro is open.\">\n<link rel=\"stylesheet\" href=\"css/theme.css\">\n<link rel=\"stylesheet\" href=\"css/layout.css\">\n</head>\n<body>\n<main>\n<h1>Opening hours</h1>\n<p>Tuesday to Sunday, 12:00 to 22:00. Closed on Mondays.</p>\n<p><a href=\"index.html\">Back to the home page</a></p>\n</main>\n</body>\n</html>\n"
}
],
"label": "Add the opening hours page"
}'

Credentials

Sent as a Bearer token and used in the samples above and in Try it. Kept only in this browser tab until you close it. Use an sk_test_ key to stay in your sandbox.

Response · 200

{
"data": {
"changed": [
"index.html"
],
"deleted": [],
"patch_failures": [],
"snapshot_id": "17",
"content_version": "2026-10-01T10:44:00.000Z",
"issues": []
}
}