Skip to main content
POST
/
api
/
v1
/
scans
Upload Scan Results
curl --request POST \
  --url http://localhost:8000/api/v1/scans \
  --header 'Content-Type: application/json' \
  --data '
{
  "scan_path": "<string>",
  "profile": "<string>",
  "checks": [
    {
      "check_id": "<string>",
      "section": "<string>",
      "title": "<string>",
      "severity": "<string>",
      "passed": true,
      "finding": "<string>",
      "remediation": "<string>",
      "config_path": "<string>"
    }
  ],
  "topology": {}
}
'
{
  "scan_id": "<string>",
  "stored": 123
}

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.

Receive scan results from a remote CLI run and store them. The CLI ships its own check list and (optionally) a derived topology snapshot for the workspace.

​
Request body — ScanUploadPayload

​
scan_path
string
required
Workspace path the scan was run against.
​
profile
string
default:"L1"
Benchmark profile.
​
checks
object[]
required
Array of check results. Each entry has:
​
topology
object
Optional topology snapshot ({nodes, edges}) as produced by the scanner’s topology builder.

​
Response

​
scan_id
string
Identifier of the stored scan
​
stored
integer
Number of check rows stored