Get a scan

Read a job returned in a 202 response. Requires scan:read and the account that submitted it. Query parameters are not supported.

get/api/v1/scan/{job_id}

Request

  • Base URL: https://control.patronus.studio
  • URL: https://control.patronus.studio/api/v1/scan/{job_id}
  • Auth: HTTP bearer

Path parameters

job_idstring required

Public job ID returned by createScan.

Response

Current job state. HTTP 200 also includes running or failed jobs; inspect status.

ark_version'1' required

Version of the internal Ark result contract interpreted by the Control Plane.

job_idstring required
sourcestring required
status'running' | 'completed' | 'failed' required
progressobject required
categoriesobject required

Results keyed by requested category: injection, dlp, pii, or threat. Check every requested category; missing results do not establish clean input.

detectorsobject

Model identifiers that reported results, keyed by category, including detectors superseded by a later category result.

decisionstring

Scan decision, when present. The client remains responsible for enforcing its policy.

safety_status'benign' | 'review' | 'attack'

Final verdict: benign or attack; review flags an inconclusive final classification or a differing decisive l3 attack chunk above 0.1 confidence at union stage and category level L3.

Changes

No recorded changes to this operation across all 1 revision of this API.