Scans

Rerun a scan

Create a new scan with the same configuration as the specified scan. For retry-safe at-most-once creation, send an Idempotency-Key and reuse the exact same key and request after a lost or ambiguous response. The key is optional for backward compatibility, retained for 24 hours, and cannot be reused with a different actor, operation, or source scan. A terminal response is replayed only after the caller still passes current source-scan authorization; revoked access returns a fresh 403/404 without exposing the receipt. Use a new key only for a deliberate new rerun.

POST

scans

{scanId}

rerun

Error

A valid request URL is required to generate request examples

{
  "scan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "title": "<string>",
  "status": "pending"
}

{
  "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>",
  "code": "scan_credit_limit_reached",
  "hint": "<string>",
  "topup_url": "<string>",
  "topup_options": [
    {
      "method": "GET",
      "path": "<string>",
      "cli": "<string>",
      "description": "<string>"
    }
  ],
  "requiredTier": "<string>",
  "plan_trial": {
    "plan": "strix_cloud",
    "trial_days": 123,
    "includes": "<string>",
    "method": "POST",
    "path": "<string>",
    "cli": "<string>",
    "url": "<string>",
    "description": "<string>"
  },
  "required_credits": 123,
  "available_credits": 123
}

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

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

{
  "detail": "<string>",
  "code": "idempotency_key_conflict",
  "terminal": true
}

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

{
  "detail": "<string>",
  "code": "idempotency_outcome_unknown",
  "retry_safe": true,
  "terminal": false,
  "scan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

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.

Headers

Idempotency-Key

string

Opaque caller-generated key for at-most-once billable scan creation; use a high-entropy value such as a UUID. Reuse the exact same key only when retrying the exact same request. Completed keys are retained for at least 24 hours; an unfinished accepted worker receipt may be held longer until its downstream queue horizon is safely reconciled. A completed failure is terminal for that key. Keyed terminal responses echo Idempotency-Key and set Idempotency-Replayed to true only when returning a stored outcome.

Required string length: 1 - 200

Pattern: ^[A-Za-z0-9][A-Za-z0-9._:/=-]{0,199}$

Path Parameters

scanId

string<uuid>

required

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

Response

Rerun scan created.

scan_id

string<uuid>

required

title

string

required

status

enum<string>

required

Available options:

pending,

running,

completed,

failed,

cancelled

Error

A valid request URL is required to generate request examples

{
  "scan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "title": "<string>",
  "status": "pending"
}

{
  "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>",
  "code": "scan_credit_limit_reached",
  "hint": "<string>",
  "topup_url": "<string>",
  "topup_options": [
    {
      "method": "GET",
      "path": "<string>",
      "cli": "<string>",
      "description": "<string>"
    }
  ],
  "requiredTier": "<string>",
  "plan_trial": {
    "plan": "strix_cloud",
    "trial_days": 123,
    "includes": "<string>",
    "method": "POST",
    "path": "<string>",
    "cli": "<string>",
    "url": "<string>",
    "description": "<string>"
  },
  "required_credits": 123,
  "available_credits": 123
}

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

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

{
  "detail": "<string>",
  "code": "idempotency_key_conflict",
  "terminal": true
}

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

{
  "detail": "<string>",
  "code": "idempotency_outcome_unknown",
  "retry_safe": true,
  "terminal": false,
  "scan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Scans

Audit

Vulnerabilities

Assets

Schedules

Tokens

Webhooks

Organization

Members

Invitations

Analytics

LLM

Connectors

Chat

PR Reviews

Knowledge

Integrations

Uploads

Test Users

License

Supply Chain

CLI

Billing

Workspaces

Rerun a scan

Authorizations

Headers

Path Parameters

Response