SoftSolzSoftSolz
HomeAPI GuideAPI ReferenceWidget Tester

Add more files to a fix set that has not been pushed yet

Same rules as creating a set. 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. 409 fix_set_locked means the set is being pushed or already pushed.

POSThttps://app.softsolz.uk/api/v1/services/seo/code/fixes/{fix_set_id}/files

Recent Requests

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

Path Params

fix_set_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 add.

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/code/fixes/{fix_set_id}/files \
--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": "/"
}
]
}'

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."
}
]
}
}