Skip to main content
POST
/
api
/
v1
/
scan
/
validate-path
Validate Workspace Path
curl --request POST \
  --url http://localhost:8000/api/v1/scan/validate-path \
  --header 'Content-Type: application/json' \
  --data '
{
  "path": "<string>"
}
'
{
  "valid": true,
  "openclaw_json_found": true,
  "path": "<string>",
  "error": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.tracectrl.ai/llms.txt

Use this file to discover all available pages before exploring further.

Used by the dashboard before kicking off a scan. The path is validated server-side because the dashboard runs in a browser that cannot inspect the engine host’s filesystem.

​
Request body — ValidatePathPayload

​
path
string
required
Absolute filesystem path (whitespace is trimmed).

​
Response

​
valid
boolean
true if the path exists and contains openclaw.json
​
openclaw_json_found
boolean
Whether openclaw.json was found
​
path
string
Echo of the resolved path
​
error
string
Reason for failure when valid is false (e.g. Path does not exist, Not an OpenClaw workspace (no openclaw.json found))