Skip to main content
POST
Error

Authorizations

​
Authorization
string
header
required

API token obtained from the Tokens endpoint or CLI device login. Include as Authorization: Bearer <token>. Requests made with a managed CLI session also include X-Strix-Workspace: <organization_id> to pin a process to the workspace it started in; recovery endpoints report the current workspace after a concurrent switch.

Path Parameters

​
vulnerabilityId
string
required

ID of the vulnerability. Use the id field of a finding from listVulnerabilities.

Body

application/json
​
upload_ids
string[]

Optional upload IDs that replace the repository uploads of the source scan for this retest.

Required array length: 1 - 20 elements
Minimum string length: 1

Response

Retest started.

​
scan_id
string
required

The retest scan. Poll GET /scans/{scanId} for its status, or read latest_retest on the issue.

​
title
string
required
​
status
enum<string>
required
Available options:
pending,
running,
completed,
failed,
cancelled
​
source_vulnerability_id
string
required

The issue that the retest verifies. When you retest a finding that a previous retest filed, this is the original issue.