Scans

Retest all findings

Starts retest scans for the findings of the scan. A single finding gets one targeted retest scan. Several findings share retest scans: one scan per group of up to 50 findings, in which every finding is checked by its own agent, all in parallel. The request checks access, the findings in scope, and the replacement uploads. Then it answers with status 202 and creates the retest scans in the background. The retest scans do not appear in the scan list. Read them, and the launches that are still starting or that failed to start, through GET /scans/{scanId}/retests on the source scan. A finding with a retest that is still running is skipped.

POST

scans

{scanId}

retest-all

Error

A valid request URL is required to generate request examples

{
  "batch_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "accepted": 123,
  "total": 123,
  "skipped_running": 123
}

{
  "batch_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "accepted": 123,
  "total": 123,
  "skipped_running": 123
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

{
  "detail": "<string>",
  "requiredTier": "<string>",
  "code": "<string>"
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

{
  "detail": "<string>",
  "code": "UPLOAD_PROCESSING"
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

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

scanId

string<uuid>

required

UUID of the scan. Use the id field of a scan from listScans.

Body

application/json

scope

enum<string>

Choose whether to retest all findings or only open findings.

Available options:

all,

open

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

No retest started. Every finding in scope is already retesting, or the scope has no findings.

batch_id

string<uuid> | null

required

The batch that starts the retests. The value is null when no retest was accepted.

accepted

integer

required

The number of retests that are starting in the background.

total

integer

required

The number of findings in the requested scope.

skipped_running

integer

required

The number of findings that the request skipped because a retest of the finding is still running or starting.

Error

A valid request URL is required to generate request examples

{
  "batch_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "accepted": 123,
  "total": 123,
  "skipped_running": 123
}

{
  "batch_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "accepted": 123,
  "total": 123,
  "skipped_running": 123
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

{
  "detail": "<string>",
  "requiredTier": "<string>",
  "code": "<string>"
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

{
  "detail": "<string>",
  "code": "UPLOAD_PROCESSING"
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

Analytics

Asset Discovery

Audit

Billing

Chat

CLI

Connectors

Containers

Assets

Test Users

Integrations

Knowledge

License

LLM

Run Logs

Organization

Invitations

Members

PR Reviews

Vulnerabilities

Supply Chain

Scans

Schedules

Search

Tokens

Uploads

Webhooks

Workspaces

Repositories

Retest all findings

Authorizations

Path Parameters

Body

Response