Skip to main content
POST
/
api
/
v1
/
scan
/
fix
Apply Scan Fixes
curl --request POST \
  --url http://localhost:8000/api/v1/scan/fix \
  --header 'Content-Type: application/json' \
  --data '
{
  "workspace_path": "<string>",
  "check_ids": [
    "<string>"
  ]
}
'
{
  "applied": [
    "<string>"
  ],
  "skipped": [
    "<string>"
  ],
  "errors": {}
}
Runs the scanner’s automated-fix functions against openclaw.json in the given workspace. A .json.bak backup is written before any change. The config file is rewritten only if at least one fix applied successfully.

​
Request body — ScanFixPayload

​
workspace_path
string
required
Path to the OpenClaw workspace (must contain openclaw.json).
​
check_ids
string[]
required
List of check IDs to attempt to fix.

​
Errors

  • 400 — openclaw.json not found at workspace path
  • 400 — Failed to parse openclaw.json
  • 503 — Scanner not installed (pip install tracectrl-scanner)

​
Response

​
applied
string[]
Check IDs whose fix ran successfully
​
skipped
string[]
Check IDs with no registered automated fix
​
errors
object
Map of check_id to error message for fixes that raised