Skip to main content
POST
/
api
/
v1
/
scans
/
start
Start a new scan
curl --request POST \
  --url https://zeropath.com/api/v1/scans/start \
  --header 'Content-Type: application/json' \
  --header 'X-ZeroPath-API-Token-Id: <api-key>' \
  --header 'X-ZeroPath-API-Token-Secret: <api-key>' \
  --data '
{
  "organizationId": "<string>",
  "repositoryIds": [
    "<string>"
  ],
  "repositories": [
    {
      "id": "<string>",
      "branch": "<string>"
    }
  ],
  "scanType": "FullScan",
  "scanTargetBranch": "<string>",
  "prTargetBranch": "<string>"
}
'
[
  "<string>"
]

Documentation Index

Fetch the complete documentation index at: https://zeropath.com/docs/llms.txt

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

Authorizations

​
X-ZeroPath-API-Token-Id
string
header
required
​
X-ZeroPath-API-Token-Secret
string
header
required

Body

application/json
​
organizationId
string
​
repositoryIds
string[]
​
repositories
object[]
​
scanType
enum<string>

Optional. Must be FullScan when provided; PR scans are webhook-triggered.

Available options:
FullScan
​
scanTargetBranch
string

Branch to scan.

​
prTargetBranch
string

Optional comparison base branch for branch-aware scans.

Response

Scan started successfully