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.
https://app.softsolz.uk/api/v1/services/launchpad/clients/{id}/site/files/applyRecent Requests
Kept only in this browserPath Params
idstringrequiredHeaders
AuthorizationstringrequiredBearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.
Idempotency-KeystringOptional idempotency key for safe retries.
Body Params
operationsarray of objectsrequiredChanges to apply, in order.
expected_versionstringcontent_version from your last read of site/files. Refused with 409 STALE_VERSION when the website changed since.
labelstringShort 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": [] }}