> ## 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.

# Upload Scan Results

> Store scan results produced by a remote TraceCtrl CLI

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:

**check\_id** `string` *required*

**section** `string` *required*

**title** `string` *required*

**severity** `string` *required*

**passed** `boolean` *required*

**finding** `string`

Defaults to empty string.

**remediation** `string`

Defaults to empty string.

**config\_path** `string`

Defaults to empty string.

**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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.