> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/api-reference/security-testing-agent-apis/security-testing-orchestration/fp-triage.md).

# Fp Triage

Agent ingest endpoints for the FP Triage agent's pre- and post-plugins

## ListOccurrencesInScope FpTriage

> List the (issue, occurrence) tuples the FP Triage agent's pre-plugin needs to build LLM prompts. Without scanId, returns the baseline-only working set for the whole project. With scanId, narrows to the one scan's occurrences.

```json
{"openapi":"3.0.3","info":{"title":"Harness Security Test Orchestration API","version":"1.0.0"},"tags":[{"name":"FpTriage","description":"Agent ingest endpoints for the FP Triage agent's pre- and post-plugins"}],"servers":[{"url":"https://app.harness.io/gateway/sto"},{"url":"http://127.0.0.1:4000"}],"security":[{"jwt_header_Authorization":["sto_internal_use_only"]}],"components":{"securitySchemes":{"jwt_header_Authorization":{"type":"http","scheme":"bearer"}},"schemas":{"ListOccurrencesInScopeResponseBody2":{"type":"object","properties":{"hasMore":{"type":"boolean","description":"True when more rows exist beyond this page. Server always sets this by fetching limit+1 and trimming."},"nextCursor":{"type":"integer","description":"occurrenceInternalId of the last returned row. Only set when hasMore is true; pass as afterOccurrenceInternalId on the next request.","format":"int64"},"results":{"type":"array","items":{"$ref":"#/components/schemas/FpOccurrenceRef"}}},"required":["results","hasMore"]},"FpOccurrenceRef":{"type":"object","properties":{"cisaKevProduct":{"type":"string","description":"CISA KEV product of the KEV CVE with the highest EPSS among this occurrence's CVEs. Omitted when none of those CVEs are in KEV."},"cisaKevVendor":{"type":"string","description":"CISA KEV vendorProject of the KEV CVE with the highest EPSS among this occurrence's CVEs. Omitted when none of those CVEs are in KEV."},"epss":{"type":"number","description":"Highest EPSS score among this occurrence's CVEs, in [0, 1]. Omitted when none of those CVEs have an EPSS score. Describes the CVE, not whether this occurrence is a false positive.","format":"double","minimum":0,"maximum":1},"epssPercentile":{"type":"number","description":"EPSS percentile of the CVE that supplied epss. Omitted when epss is omitted.","format":"double","minimum":0,"maximum":1},"exempted":{"type":"boolean","description":"True when this occurrence is covered by an Approved exemption. Present only when includeExempted=true and the row is exempted; omitted otherwise. When includeExempted is false, exempted rows are dropped and this field is never sent."},"inCisaKev":{"type":"boolean","description":"True when any of this occurrence's CVEs is in the CISA Known Exploited Vulnerabilities catalog. Omitted when false or unknown."},"issueCves":{"type":"array","items":{"type":"string"},"description":"Per-scan union of CVE-type ids from issue_scan.cves (computed at ingest). Treat as a cross-check only — not a complete identifier set. Omitted when null or empty; older or non-CVE scans (including some non-baseline scans) may have no value."},"issueDetails":{"type":"string","description":"Opaque JSON object from issue.details — pass-through to the LLM prompt builder","format":"binary"},"issueId":{"type":"string","description":"STO issue ID","pattern":"^[a-zA-Z0-9_-]{22}$"},"issueInternalId":{"type":"integer","description":"STO internal numeric issue ID — stable within an account, used by the agent for joins","format":"int64"},"issueKey":{"type":"string","description":"Stable scanner-facing issue key (issue.key)"},"issueSeverityCode":{"type":"string","description":"Issue-level severity bucket (issue.severity_code). Distinct from severityCode, which is resolved per occurrence."},"issueTitle":{"type":"string","description":"Human-readable issue title"},"issueType":{"type":"string","description":"Scanner-family issue type (SAST, SCA, SECRET, etc.)"},"occurrenceCves":{"type":"array","items":{"type":"string"},"description":"CVE ids on this occurrence only, from its referenceIdentifiers. Not the issue-level union. Omitted when this occurrence has no CVEs. EPSS and CISA KEV on this row are computed from this list."},"occurrenceDetails":{"type":"string","description":"Opaque JSON object from occurrence.unique_details — pass-through to the LLM prompt builder","format":"binary"},"occurrenceInternalId":{"type":"integer","description":"STO internal numeric occurrence ID","format":"int64"},"productName":{"type":"string","description":"Scanner product name (e.g. semgrep, snyk, trivy)"},"scanId":{"type":"string","description":"STO scan id that produced this occurrence","pattern":"^[a-zA-Z0-9_-]{22}$"},"severityCode":{"type":"string","description":"Per-occurrence severity bucket (Critical/High/Medium/Low/Info)"},"targetId":{"type":"string","description":"STO target ID. May be null if the occurrence was emitted before target association."},"targetName":{"type":"string","description":"Human-readable target name"},"targetVariantId":{"type":"string","description":"STO target variant id of the scan that produced this occurrence","pattern":"^[a-zA-Z0-9_-]{22}$"}},"description":"In-scope (issue, occurrence) tuple for the FP Triage agent's pre-plugin","required":["issueId","issueInternalId","occurrenceInternalId","issueTitle","severityCode"]},"NotFound":{"type":"object","properties":{"message":{"type":"string"},"status":{"type":"integer","default":404,"format":"int64"}},"required":["message"]}}},"paths":{"/api/v2/fp-triage/occurrences-in-scope":{"get":{"tags":["FpTriage"],"summary":"ListOccurrencesInScope FpTriage","description":"List the (issue, occurrence) tuples the FP Triage agent's pre-plugin needs to build LLM prompts. Without scanId, returns the baseline-only working set for the whole project. With scanId, narrows to the one scan's occurrences.","operationId":"FpTriage#ListOccurrencesInScope","parameters":[{"name":"accountId","in":"query","description":"Harness Account ID","allowEmptyValue":true,"required":true,"schema":{"type":"string","description":"Harness Account ID","pattern":"^[a-zA-Z0-9_-]{22}$"}},{"name":"orgId","in":"query","description":"Harness Organization ID","allowEmptyValue":true,"required":true,"schema":{"type":"string","description":"Harness Organization ID","pattern":"^[A-Za-z_][A-Za-z0-9_]*$","maxLength":128}},{"name":"projectId","in":"query","description":"Harness Project ID","allowEmptyValue":true,"required":true,"schema":{"type":"string","description":"Harness Project ID","pattern":"^[A-Za-z_][A-Za-z0-9_]*$","maxLength":128}},{"name":"scanId","in":"query","description":"Optional STO scan id. When set, the working set is narrowed to occurrences produced by that one scan (scan-completion trigger path). Omit on the cron / project-level trigger path. ssca-manager passes the scanId it received from the stoScanInfo Redis Streams event.","allowEmptyValue":true,"schema":{"type":"string","description":"Optional STO scan id. When set, the working set is narrowed to occurrences produced by that one scan (scan-completion trigger path). Omit on the cron / project-level trigger path. ssca-manager passes the scanId it received from the stoScanInfo Redis Streams event.","pattern":"^[a-zA-Z0-9_-]{22}$"}},{"name":"targetId","in":"query","description":"Optional STO target id. Used in conjunction with scanId on the scan-completion trigger path as a defensive predicate against scan.target. Ignored when scanId is empty. ssca-manager passes the targetId it received from the stoScanInfo Redis Streams event.","allowEmptyValue":true,"schema":{"type":"string","description":"Optional STO target id. Used in conjunction with scanId on the scan-completion trigger path as a defensive predicate against scan.target. Ignored when scanId is empty. ssca-manager passes the targetId it received from the stoScanInfo Redis Streams event.","pattern":"^[a-zA-Z0-9_-]{22}$"}},{"name":"includeAlreadyTriaged","in":"query","description":"When false, skip occurrences that already have an fp_triage_agent verdict. Honoured with or without scanId.","allowEmptyValue":true,"schema":{"type":"boolean","description":"When false, skip occurrences that already have an fp_triage_agent verdict. Honoured with or without scanId.","default":true}},{"name":"limit","in":"query","description":"Maximum number of occurrences to return","allowEmptyValue":true,"schema":{"type":"integer","description":"Maximum number of occurrences to return","default":1000,"format":"int64","minimum":1,"maximum":10000}},{"name":"scanTypes","in":"query","description":"Per-checkbox subset of the Configuration tab's \"Scan Types to Triage\". Allowed: SCA (issue_type=SCA AND target.type=repository), SAST (issue_type=SAST), CONTAINER (issue_type=SCA AND target.type IN ('container','instance')), SECRET (issue_type=SECRET), IAC (issue_type IN ('IAC','MISCONFIG')), DAST (issue_type=DAST). Empty / absent means \"include every supported (issue_type, target.type) tuple\".","allowEmptyValue":true,"schema":{"type":"array","items":{"type":"string","enum":["SCA","SAST","CONTAINER","SECRET","IAC","DAST"]},"description":"Per-checkbox subset of the Configuration tab's \"Scan Types to Triage\". Allowed: SCA (issue_type=SCA AND target.type=repository), SAST (issue_type=SAST), CONTAINER (issue_type=SCA AND target.type IN ('container','instance')), SECRET (issue_type=SECRET), IAC (issue_type IN ('IAC','MISCONFIG')), DAST (issue_type=DAST). Empty / absent means \"include every supported (issue_type, target.type) tuple\"."}},{"name":"severityCodes","in":"query","description":"Per-checkbox subset of the Configuration tab's \"Severity Types to Triage\". Allowed: CRITICAL, HIGH, MEDIUM, LOW, INFO (compared case-insensitively against per-occurrence severity). Empty / absent means \"include every severity\".","allowEmptyValue":true,"schema":{"type":"array","items":{"type":"string","enum":["CRITICAL","HIGH","MEDIUM","LOW","INFO"]},"description":"Per-checkbox subset of the Configuration tab's \"Severity Types to Triage\". Allowed: CRITICAL, HIGH, MEDIUM, LOW, INFO (compared case-insensitively against per-occurrence severity). Empty / absent means \"include every severity\"."}},{"name":"excludeRepoPatterns","in":"query","description":"Glob patterns matching target.name on repository targets (target.type='repository'). Any occurrence whose target name matches ANY pattern is excluded. Glob syntax: '*' = any run of chars, '?' = single char. The handler converts each glob to a Postgres LIKE pattern server-side. Empty / absent means \"exclude no repositories\".","allowEmptyValue":true,"schema":{"type":"array","items":{"type":"string","maxLength":256},"description":"Glob patterns matching target.name on repository targets (target.type='repository'). Any occurrence whose target name matches ANY pattern is excluded. Glob syntax: '*' = any run of chars, '?' = single char. The handler converts each glob to a Postgres LIKE pattern server-side. Empty / absent means \"exclude no repositories\"."}},{"name":"excludeArtifactPatterns","in":"query","description":"Glob patterns matching target.name on artifact targets (target.type IN ('container','instance')). Same semantics as excludeRepoPatterns but applied to the artifact target buckets. Empty / absent means \"exclude no artifacts\".","allowEmptyValue":true,"schema":{"type":"array","items":{"type":"string","maxLength":256},"description":"Glob patterns matching target.name on artifact targets (target.type IN ('container','instance')). Same semantics as excludeRepoPatterns but applied to the artifact target buckets. Empty / absent means \"exclude no artifacts\"."}},{"name":"baselineOnly","in":"query","description":"When true (default), the scanId path only returns occurrences from the latest baseline scan for that target (existing FP-triage behaviour). When false AND scanId is set, both baseline restrictions are removed so any user-chosen scan can be read. Ignored on the project path (empty scanId), which always iterates latest baseline scans.","allowEmptyValue":true,"schema":{"type":"boolean","description":"When true (default), the scanId path only returns occurrences from the latest baseline scan for that target (existing FP-triage behaviour). When false AND scanId is set, both baseline restrictions are removed so any user-chosen scan can be read. Ignored on the project path (empty scanId), which always iterates latest baseline scans.","default":true}},{"name":"includeExempted","in":"query","description":"When false (default), occurrences covered by an Approved exemption are dropped. When true, those rows are returned with exempted=true instead of being filtered out. Applies on both scan and project paths.","allowEmptyValue":true,"schema":{"type":"boolean","description":"When false (default), occurrences covered by an Approved exemption are dropped. When true, those rows are returned with exempted=true instead of being filtered out. Applies on both scan and project paths.","default":false}},{"name":"afterOccurrenceInternalId","in":"query","description":"Keyset pagination cursor. When set, only rows with occurrenceInternalId strictly greater than this value are returned. Both paths already ORDER BY occurrenceInternalId ascending. Omit (or pass with hasMore/nextCursor from a prior page) to start from the beginning.","allowEmptyValue":true,"schema":{"type":"integer","description":"Keyset pagination cursor. When set, only rows with occurrenceInternalId strictly greater than this value are returned. Both paths already ORDER BY occurrenceInternalId ascending. Omit (or pass with hasMore/nextCursor from a prior page) to start from the beginning.","format":"int64","minimum":0}},{"name":"issueDetailsOncePerPage","in":"query","description":"When false (default), every row carries its issueDetails blob. When true, issueDetails is populated only on the first row (lowest occurrenceInternalId) of each issue within the returned page; subsequent rows of the same issue get null. Reduces payload size for large SCA scans where many occurrences share one issue.","allowEmptyValue":true,"schema":{"type":"boolean","description":"When false (default), every row carries its issueDetails blob. When true, issueDetails is populated only on the first row (lowest occurrenceInternalId) of each issue within the returned page; subsequent rows of the same issue get null. Reduces payload size for large SCA scans where many occurrences share one issue.","default":false}}],"responses":{"200":{"description":"OK response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListOccurrencesInScopeResponseBody2"}}}},"400":{"description":"BadRequest: Bad Request response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}}},"401":{"description":"Unauthorized: Unauthorized response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}}},"403":{"description":"Forbidden: Forbidden response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}}},"429":{"description":"TooManyRequests: Too Many Requests response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}}},"500":{"description":"InternalServerError: Internal Server Error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}}}}}}}}
```

## BatchUpsertVerdicts FpTriage

> Atomically upsert a batch of per-occurrence FP triage verdicts produced by one agent run. The store-level transaction rolls back the whole batch on any single failure so the aggregated rollup stays consistent.

```json
{"openapi":"3.0.3","info":{"title":"Harness Security Test Orchestration API","version":"1.0.0"},"tags":[{"name":"FpTriage","description":"Agent ingest endpoints for the FP Triage agent's pre- and post-plugins"}],"servers":[{"url":"https://app.harness.io/gateway/sto"},{"url":"http://127.0.0.1:4000"}],"security":[{"jwt_header_Authorization":["sto_internal_use_only"]}],"components":{"securitySchemes":{"jwt_header_Authorization":{"type":"http","scheme":"bearer"}},"schemas":{"BatchUpsertVerdictsRequestBody":{"type":"object","properties":{"verdicts":{"type":"array","items":{"$ref":"#/components/schemas/FpVerdictPayload"},"description":"Verdicts to upsert. ON CONFLICT (account_id, workflow_type, issue_id, occurrence_internal_id) DO UPDATE — re-runs overwrite previous output.","minItems":1,"maxItems":10000}},"required":["verdicts"]},"FpVerdictPayload":{"type":"object","properties":{"confidence":{"type":"number","description":"Model-reported confidence in the verdict, in [0, 1]","format":"double","minimum":0,"maximum":1},"issueId":{"type":"string","description":"STO issue ID the verdict applies to","pattern":"^[a-zA-Z0-9_-]{22}$"},"modelName":{"type":"string","description":"Identifier of the model that produced this verdict (incl. version)","maxLength":256},"occurrenceInternalId":{"type":"integer","description":"STO internal occurrence ID the verdict applies to","format":"int64"},"promptVersion":{"type":"string","description":"Version of the prompt template used","maxLength":64},"reasoning":{"type":"string","description":"LLM-emitted natural-language justification for the verdict"},"targetId":{"type":"string","description":"STO target ID. Optional — verdicts predating target association may omit this.","pattern":"^[a-zA-Z0-9_-]{22}$"},"verdict":{"type":"string","description":"Per-occurrence verdict label emitted by the LLM","enum":["FALSE_POSITIVE","TRUE_POSITIVE"]},"workflowExecutionId":{"type":"string","description":"Opaque ssca-manager workflow execution ID that produced this verdict — audit trail only","maxLength":64},"workflowType":{"type":"string","description":"Discriminator for the agent family inside the shared triage_verdict table. Defaults to FP_TRIAGE; reserved for future agents (auto-fix, exploitability, etc.).","default":"FP_TRIAGE","maxLength":64}},"description":"One verdict produced by the FP Triage agent for one occurrence","required":["issueId","occurrenceInternalId","verdict","confidence","modelName","promptVersion"]},"BatchUpsertVerdictsResponseBody":{"type":"object","properties":{"written":{"type":"integer","description":"Number of verdict rows written (inserted or updated).","format":"int64"}},"required":["written"]},"NotFound":{"type":"object","properties":{"message":{"type":"string"},"status":{"type":"integer","default":404,"format":"int64"}},"required":["message"]}}},"paths":{"/api/v2/fp-triage/verdicts/batch":{"post":{"tags":["FpTriage"],"summary":"BatchUpsertVerdicts FpTriage","description":"Atomically upsert a batch of per-occurrence FP triage verdicts produced by one agent run. The store-level transaction rolls back the whole batch on any single failure so the aggregated rollup stays consistent.","operationId":"FpTriage#BatchUpsertVerdicts","parameters":[{"name":"accountId","in":"query","description":"Harness Account ID","allowEmptyValue":true,"required":true,"schema":{"type":"string","description":"Harness Account ID","pattern":"^[a-zA-Z0-9_-]{22}$"}},{"name":"orgId","in":"query","description":"Harness Organization ID","allowEmptyValue":true,"required":true,"schema":{"type":"string","description":"Harness Organization ID","pattern":"^[A-Za-z_][A-Za-z0-9_]*$","maxLength":128}},{"name":"projectId","in":"query","description":"Harness Project ID","allowEmptyValue":true,"required":true,"schema":{"type":"string","description":"Harness Project ID","pattern":"^[A-Za-z_][A-Za-z0-9_]*$","maxLength":128}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchUpsertVerdictsRequestBody"}}}},"responses":{"200":{"description":"OK response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchUpsertVerdictsResponseBody"}}}},"400":{"description":"BadRequest: Bad Request response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}}},"401":{"description":"Unauthorized: Unauthorized response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}}},"403":{"description":"Forbidden: Forbidden response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}}},"429":{"description":"TooManyRequests: Too Many Requests response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}}},"500":{"description":"InternalServerError: Internal Server Error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}}}}}}}}
```

## GetScanContext FpTriage

> Resolve the STO scan an agent pre-plugin should use. With scanId, returns that scan's org, project, target, and variant. With targetName (and optional targetVariant / scanner), returns the latest succeeded scan on the resolved variant in orgId/projectId. targetVariant omitted uses the target baseline variant. scanner omitted returns the latest succeeded scan across products. A scanner value keeps only that product. With neither scanId nor targetName, pipelineExecutionId returns the latest succeeded scan on that pipeline execution. Served at /api/v2/scan-context.

```json
{"openapi":"3.0.3","info":{"title":"Harness Security Test Orchestration API","version":"1.0.0"},"tags":[{"name":"FpTriage","description":"Agent ingest endpoints for the FP Triage agent's pre- and post-plugins"}],"servers":[{"url":"https://app.harness.io/gateway/sto"},{"url":"http://127.0.0.1:4000"}],"security":[{"jwt_header_Authorization":["sto_internal_use_only"]}],"components":{"securitySchemes":{"jwt_header_Authorization":{"type":"http","scheme":"bearer"}},"schemas":{"FpScanContext":{"type":"object","properties":{"accountId":{"type":"string","description":"Harness account id from the scan (or target) row"},"gitMetadata":{"$ref":"#/components/schemas/GitMetadata"},"orgId":{"type":"string","description":"Harness organization id from hierarchy_lookup"},"parentUniqueId":{"type":"string","description":"hierarchy_lookup / scan parent_unique_id"},"productName":{"type":"string","description":"Scanner product name of the resolved scan"},"projectId":{"type":"string","description":"Harness project id from hierarchy_lookup"},"scanId":{"type":"string","description":"Resolved STO scan id","pattern":"^[a-zA-Z0-9_-]{22}$"},"targetId":{"type":"string","description":"STO target id of the resolved scan","pattern":"^[a-zA-Z0-9_-]{22}$"},"targetName":{"type":"string","description":"Human-readable target name"},"targetVariantId":{"type":"string","description":"STO target variant id of the resolved scan","pattern":"^[a-zA-Z0-9_-]{22}$"},"targetVariantName":{"type":"string","description":"Variant name from target_variant.parameters->>'variant'"}},"required":["accountId","orgId","projectId","scanId","targetId"]},"GitMetadata":{"type":"object","properties":{"commit":{"type":"string","description":"Git Commit SHA scanned"},"detectedName":{"type":"string","description":"Detected Name"},"detectedVariant":{"type":"string","description":"Detected Variant"},"droneCorrelated":{"type":"boolean","description":"Drone Correlated"},"provider":{"type":"string","description":"Git Provider"},"pullRequestNumber":{"type":"integer","description":"Git Pull Request Number","format":"int64"},"repositoryHttp":{"type":"string","description":"Git HTTP Repository"},"repositoryPath":{"type":"array","items":{"type":"string"},"description":"Git Repository Path"},"repositorySsh":{"type":"string","description":"Git SSH Repository"},"sourceBranch":{"type":"string","description":"Git Source Branch"},"targetBranch":{"type":"string","description":"Git Target Branch"},"workspace":{"type":"string","description":"Git Workspace Root"}},"description":"Git Metadata associated with the Scan"},"NotFound":{"type":"object","properties":{"message":{"type":"string"},"status":{"type":"integer","default":404,"format":"int64"}},"required":["message"]}}},"paths":{"/api/v2/scan-context":{"get":{"tags":["FpTriage"],"summary":"GetScanContext FpTriage","description":"Resolve the STO scan an agent pre-plugin should use. With scanId, returns that scan's org, project, target, and variant. With targetName (and optional targetVariant / scanner), returns the latest succeeded scan on the resolved variant in orgId/projectId. targetVariant omitted uses the target baseline variant. scanner omitted returns the latest succeeded scan across products. A scanner value keeps only that product. With neither scanId nor targetName, pipelineExecutionId returns the latest succeeded scan on that pipeline execution. Served at /api/v2/scan-context.","operationId":"FpTriage#GetScanContext","parameters":[{"name":"accountId","in":"query","description":"Harness Account ID","allowEmptyValue":true,"required":true,"schema":{"type":"string","description":"Harness Account ID","pattern":"^[a-zA-Z0-9_-]{22}$"}},{"name":"scanId","in":"query","description":"Optional STO scan id. When set, this scan is used and targetName, targetVariant, scanner, and pipelineExecutionId are ignored.","allowEmptyValue":true,"schema":{"type":"string","description":"Optional STO scan id. When set, this scan is used and targetName, targetVariant, scanner, and pipelineExecutionId are ignored.","pattern":"^[a-zA-Z0-9_-]{22}$"}},{"name":"orgId","in":"query","description":"Harness organization id. Required with targetName.","allowEmptyValue":true,"schema":{"type":"string","description":"Harness organization id. Required with targetName.","maxLength":256}},{"name":"projectId","in":"query","description":"Harness project id. Required with targetName.","allowEmptyValue":true,"schema":{"type":"string","description":"Harness project id. Required with targetName.","maxLength":256}},{"name":"targetName","in":"query","description":"Optional STO target name, the same name a scan step uses. Combined with targetVariant (or the target baseline variant) to pick the latest succeeded scan in orgId/projectId. A name that matches more than one target type in that project is rejected.","allowEmptyValue":true,"schema":{"type":"string","description":"Optional STO target name, the same name a scan step uses. Combined with targetVariant (or the target baseline variant) to pick the latest succeeded scan in orgId/projectId. A name that matches more than one target type in that project is rejected.","maxLength":1024}},{"name":"targetVariant","in":"query","description":"Optional target variant id or variant name (target_variant.parameters->>'variant'). Ignored when scanId is set. When empty on the targetName path, the target baseline variant is used.","allowEmptyValue":true,"schema":{"type":"string","description":"Optional target variant id or variant name (target_variant.parameters->>'variant'). Ignored when scanId is set. When empty on the targetName path, the target baseline variant is used.","maxLength":256}},{"name":"scanner","in":"query","description":"Optional scanner product id, name, or display name (e.g. semgrep, Semgrep). Ignored when scanId is set. When set, the latest succeeded scan is limited to the product whose id, name, or pretty_name matches case-insensitively.","allowEmptyValue":true,"schema":{"type":"string","description":"Optional scanner product id, name, or display name (e.g. semgrep, Semgrep). Ignored when scanId is set. When set, the latest succeeded scan is limited to the product whose id, name, or pretty_name matches case-insensitively.","maxLength":128}},{"name":"pipelineExecutionId","in":"query","description":"Optional Harness pipeline execution id. Used only when scanId and targetName are both empty. Returns the latest succeeded scan recorded on that execution (scan.execution_id).","allowEmptyValue":true,"schema":{"type":"string","description":"Optional Harness pipeline execution id. Used only when scanId and targetName are both empty. Returns the latest succeeded scan recorded on that execution (scan.execution_id).","pattern":"^[a-zA-Z0-9_-]{22}$"}}],"responses":{"200":{"description":"OK response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FpScanContext"}}}},"400":{"description":"BadRequest: Bad Request response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}}},"401":{"description":"Unauthorized: Unauthorized response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}}},"403":{"description":"Forbidden: Forbidden response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}}},"404":{"description":"NotFound: Not Found response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}}},"429":{"description":"TooManyRequests: Too Many Requests response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}}},"500":{"description":"InternalServerError: Internal Server Error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}}}}}}}}
```
