SoftSolzSoftSolz
HomeAPI GuideAPI ReferenceWidget Tester

Create a fix set from files you rewrote

Read the audit findings, fetch the current file content from the repository yourself, rewrite only the wording and metadata, then send 1 to 50 files with their full new content. SoftSolz reads the original from the branch head and diffs it. Every file passes the same guard as the dashboard: only wording and head/metadata tags may change, stylesheets, images and config files are refused (fix_touches_design), and the layout fingerprint of an updated page must be identical. Only robots.txt, sitemap.xml, llms.txt and security.txt may be created. Refused files come back in refused with the reason; fix them and send again. Spends no SoftSolz AI credits. Bodies are capped at 1 MB, so send big sets in batches with POST /code/fixes/{fix_set_id}/files.

POSThttps://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/code/repos/{repo_id}/fixes

Recent Requests

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

Path Params

site_idstringrequired
repo_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

filesarray of objectsrequired

Files to change.

base_branchstring

Branch to read from and target, default the repository default branch.

Response

Response Body

setobjectA set of content fixes destined for one pull request.
filesarray of objectsFiles accepted into the set.
refusedarray of objectsFiles the guard refused, with the reason to fix and resend.

Request

curl --request POST \
--url https://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/code/repos/{repo_id}/fixes \
--header 'Authorization: Bearer sk_live_your_key' \
--header 'Content-Type: application/json' \
--data '{
"files": [
{
"file_path": "src/pages/index.astro",
"after_content": "<html lang=\"en\"><head><title>Acme Bakery</title>...",
"title": "Add a meta description",
"reason": "The audit found no meta description on the home page.",
"page_path": "/"
}
],
"base_branch": "main"
}'

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 · 201

{
"data": {
"set": {
"id": "3f2b9c44-8f4e-4d0a-9c1b-2a7d6e5f1a23",
"site_id": "3f2b9c44-8f4e-4d0a-9c1b-2a7d6e5f1a23",
"repo_id": "3f2b9c44-8f4e-4d0a-9c1b-2a7d6e5f1a23",
"audit_id": null,
"status": "drafting",
"base_branch": "main",
"base_sha": null,
"branch_name": "softsolz/seo-content-3f2b9c448f4e",
"pull_request_url": null,
"pull_request_number": 42,
"merged_at": null,
"closed_at": null,
"merge_commit_sha": null,
"summary_markdown": null,
"model_id": "external",
"credits_used": 0,
"error_message": null,
"source": "api",
"author_label": "Claude",
"created_at": "2026-09-01T09:00:00.000Z",
"updated_at": "2026-09-01T09:00:00.000Z"
},
"files": [
{
"id": "3f2b9c44-8f4e-4d0a-9c1b-2a7d6e5f1a23",
"fix_set_id": "3f2b9c44-8f4e-4d0a-9c1b-2a7d6e5f1a23",
"file_path": "src/pages/index.astro",
"change_kind": "update",
"title": "Add a meta description",
"reason": null,
"page_path": "/",
"check_ids": [
"description_present"
],
"included": true,
"after_bytes": 4210,
"before_content": null,
"after_content": null
}
],
"refused": [
{
"file_path": "src/styles/global.css",
"code": "fix_touches_design",
"message": "\"src/styles/global.css\" controls how the site looks, so it is left alone."
}
]
}
}