> 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/artifacts.md).

# Artifacts

Read APIs for the Artifacts page.

## List artifacts

> List artifacts for a project.

```json
{"openapi":"3.0.3","info":{"title":"Harness Security Test Orchestration API","version":"1.0.0"},"tags":[{"name":"Artifacts","description":"Read APIs for the Artifacts page."}],"servers":[{"url":"https://app.harness.io/gateway/sto"},{"url":"http://127.0.0.1:4000"}],"security":[{"jwt_header_Authorization":["sto_testtarget_view"]}],"components":{"securitySchemes":{"jwt_header_Authorization":{"type":"http","scheme":"bearer"}},"schemas":{"ArtifactsListArtifactsResponseBody":{"type":"object","properties":{"pagination":{"$ref":"#/components/schemas/Pagination"},"results":{"type":"array","items":{"$ref":"#/components/schemas/Artifact"}}},"required":["results","pagination"]},"Pagination":{"type":"object","properties":{"link":{"type":"string","description":"Link-based paging"},"page":{"type":"integer","description":"Page number (starting from 0)","format":"int64"},"pageSize":{"type":"integer","description":"Requested page size","format":"int64"},"totalItems":{"type":"integer","description":"Total results available","format":"int64"},"totalPages":{"type":"integer","description":"Total pages available","format":"int64"}},"required":["page","pageSize","totalPages","totalItems"]},"Artifact":{"type":"object","properties":{"executionId":{"type":"string","description":"CI execution identifier. With pipelineId and the request org/project, FE can construct a Harness execution URL when executionUrl is empty.","maxLength":128},"executionSource":{"type":"string","description":"CI/CD platform of the last execution (harness, jenkins, github_actions, gitlab_ci, ...). Distinct from artifact/repo registry source. Omitted when unknown.","maxLength":256},"executionUrl":{"type":"string","description":"Deep link from scan metadata (non-Harness). For Harness, often empty; FE constructs from pipelineId, executionId, and the request org/project.","maxLength":1024},"id":{"type":"string","description":"Target id"},"isBaseline":{"type":"boolean","description":"Whether this variant is the baseline"},"isDigest":{"type":"boolean","description":"True when the displayed version equals the latest non-empty scan digest on the last execution (tag was a digest, or the artifact was scanned by digest)","default":false},"issueSeverityCounts":{"$ref":"#/components/schemas/ArtifactSeverityCounts"},"lastScanAt":{"type":"integer","description":"Last scan time in milliseconds since Unix epoch","format":"int64"},"name":{"type":"string","description":"Artifact name"},"occurrenceSeverityCounts":{"$ref":"#/components/schemas/ArtifactSeverityCounts"},"pipelineId":{"type":"string","description":"Harness pipeline identifier (not the pretty pipelineName). Used with executionId to construct a Harness execution URL when executionUrl is empty.","maxLength":128},"scanType":{"type":"object","description":"Scan types mapped to scanner ids and display names","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/ScanTypeScanner"}}},"source":{"type":"string","description":"Artifact source for the tracked version's latest execution. Omitted when unknown. Values are snake_case: docker_hub, harness, aws_ecr, google, azure, github, jfrog_artifactory, docker_v2, local_image, local_archive.","maxLength":256},"targetVariantId":{"type":"string","description":"Target variant id"},"type":{"type":"string","description":"Target type","enum":["container","instance","configuration"]},"url":{"type":"string","description":"Artifact URL","maxLength":1024},"version":{"type":"string","description":"Version or tag"}},"description":"An artifact.","required":["id","name","type","scanType","occurrenceSeverityCounts","issueSeverityCounts"]},"ArtifactSeverityCounts":{"type":"object","properties":{"critical":{"type":"integer","description":"Critical count","format":"int64","minimum":0},"high":{"type":"integer","description":"High count","format":"int64","minimum":0},"info":{"type":"integer","description":"Info count","format":"int64","minimum":0},"low":{"type":"integer","description":"Low count","format":"int64","minimum":0},"medium":{"type":"integer","description":"Medium count","format":"int64","minimum":0},"unassigned":{"type":"integer","description":"Unassigned count","format":"int64","minimum":0}},"description":"Counts by severity.","required":["critical","high","medium","low","info","unassigned"]},"ScanTypeScanner":{"type":"object","properties":{"id":{"type":"string","description":"Scanner product name used as the filter id"},"prettyName":{"type":"string","description":"Scanner display name (product.prettyName, falling back to product name)"}},"required":["id","prettyName"]},"NotFound":{"type":"object","properties":{"message":{"type":"string"},"status":{"type":"integer","default":404,"format":"int64"}},"required":["message"]}}},"paths":{"/api/v2/artifacts":{"get":{"description":"List artifacts for a project.","operationId":"Artifacts#ListArtifacts","parameters":[{"allowEmptyValue":true,"description":"Harness Account ID","in":"query","name":"accountId","required":true,"schema":{"description":"Harness Account ID","pattern":"^[a-zA-Z0-9_-]{22}$","type":"string"}},{"allowEmptyValue":true,"description":"Harness Organization ID","in":"query","name":"orgId","required":true,"schema":{"description":"Harness Organization ID","maxLength":128,"pattern":"^[A-Za-z_][A-Za-z0-9_]*$","type":"string"}},{"allowEmptyValue":true,"description":"Harness Project ID","in":"query","name":"projectId","required":true,"schema":{"description":"Harness Project ID","maxLength":128,"pattern":"^[A-Za-z_][A-Za-z0-9_]*$","type":"string"}},{"allowEmptyValue":true,"description":"Page number to fetch (starting from 0)","in":"query","name":"page","schema":{"default":0,"description":"Page number to fetch (starting from 0)","format":"int64","minimum":0,"type":"integer"}},{"allowEmptyValue":true,"description":"Number of results per page","in":"query","name":"pageSize","schema":{"default":30,"description":"Number of results per page","format":"int64","maximum":100,"minimum":1,"type":"integer"}},{"allowEmptyValue":true,"description":"Sort field","in":"query","name":"sort","schema":{"default":"lastScanAt","description":"Sort field","enum":["severity","lastScanAt"],"type":"string"}},{"allowEmptyValue":true,"description":"Sort direction","in":"query","name":"order","schema":{"default":"DESC","description":"Sort direction","enum":["ASC","DESC"],"type":"string"}},{"allowEmptyValue":true,"description":"Case-insensitive name substring","in":"query","name":"search","schema":{"description":"Case-insensitive name substring","maxLength":256,"type":"string"}},{"allowEmptyValue":true,"description":"Comma-separated target types. Empty means container.","in":"query","name":"types","schema":{"description":"Comma-separated target types. Empty means container.","maxLength":64,"pattern":"^((container|instance|configuration)(,(container|instance|configuration))*)?$","type":"string"}},{"allowEmptyValue":true,"description":"Comma-separated artifact sources. Use Unknown for null/empty artifact_source.","in":"query","name":"source","schema":{"description":"Comma-separated artifact sources. Use Unknown for null/empty artifact_source.","maxLength":1024,"pattern":"^([^,]+(,[^,]+)*)?$","type":"string"}},{"allowEmptyValue":true,"description":"Comma-separated scan types","in":"query","name":"scanTypes","schema":{"description":"Comma-separated scan types","maxLength":256,"pattern":"^([^,]+(,[^,]+)*)?$","type":"string"}},{"allowEmptyValue":true,"description":"Comma-separated scanner names","in":"query","name":"scanners","schema":{"description":"Comma-separated scanner names","maxLength":512,"pattern":"^([^,]+(,[^,]+)*)?$","type":"string"}},{"allowEmptyValue":true,"description":"Comma-separated severities with a non-zero occurrence count","in":"query","name":"severity","schema":{"description":"Comma-separated severities with a non-zero occurrence count","pattern":"^((critical|high|medium|low|info|unassigned)(,(critical|high|medium|low|info|unassigned))*)?$","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactsListArtifactsResponseBody"}}},"description":"OK response."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}},"description":"BadRequest: Bad Request response."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}},"description":"Unauthorized: Unauthorized response."},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}},"description":"Forbidden: Forbidden response."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}},"description":"NotFound: Not Found response."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}},"description":"TooManyRequests: Too Many Requests response."},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}},"description":"InternalServerError: Internal Server Error response."}},"summary":"List artifacts","tags":["Artifacts"]}}}}
```

## List an artifact target's digests

> Paginated unique digest strings for an artifact target. When variantId is omitted, unique digests come from the target's executions newest-first up to pageSize. When set, the same unique list is scoped to that version. Empty fingerprints fall back to the variant/tag name. Used as the scan-history digest filter dropdown.

```json
{"openapi":"3.0.3","info":{"title":"Harness Security Test Orchestration API","version":"1.0.0"},"tags":[{"name":"Artifacts","description":"Read APIs for the Artifacts page."}],"servers":[{"url":"https://app.harness.io/gateway/sto"},{"url":"http://127.0.0.1:4000"}],"security":[{"jwt_header_Authorization":["sto_testtarget_view"]}],"components":{"securitySchemes":{"jwt_header_Authorization":{"type":"http","scheme":"bearer"}},"schemas":{"ArtifactsListArtifactDigestsResponseBody":{"type":"object","properties":{"pagination":{"$ref":"#/components/schemas/Pagination"},"results":{"type":"array","items":{"type":"string"},"description":"Distinct effective digests: fingerprints, plus variant/tag name when a succeeded scan has an empty fingerprint"}},"required":["results","pagination"]},"Pagination":{"type":"object","properties":{"link":{"type":"string","description":"Link-based paging"},"page":{"type":"integer","description":"Page number (starting from 0)","format":"int64"},"pageSize":{"type":"integer","description":"Requested page size","format":"int64"},"totalItems":{"type":"integer","description":"Total results available","format":"int64"},"totalPages":{"type":"integer","description":"Total pages available","format":"int64"}},"required":["page","pageSize","totalPages","totalItems"]},"NotFound":{"type":"object","properties":{"message":{"type":"string"},"status":{"type":"integer","default":404,"format":"int64"}},"required":["message"]}}},"paths":{"/api/v2/artifacts/{id}/digests":{"get":{"description":"Paginated unique digest strings for an artifact target. When variantId is omitted, unique digests come from the target's executions newest-first up to pageSize. When set, the same unique list is scoped to that version. Empty fingerprints fall back to the variant/tag name. Used as the scan-history digest filter dropdown.","operationId":"Artifacts#ListArtifactDigests","parameters":[{"allowEmptyValue":true,"description":"Harness Account ID","in":"query","name":"accountId","required":true,"schema":{"description":"Harness Account ID","pattern":"^[a-zA-Z0-9_-]{22}$","type":"string"}},{"allowEmptyValue":true,"description":"Harness Organization ID","in":"query","name":"orgId","required":true,"schema":{"description":"Harness Organization ID","maxLength":128,"pattern":"^[A-Za-z_][A-Za-z0-9_]*$","type":"string"}},{"allowEmptyValue":true,"description":"Harness Project ID","in":"query","name":"projectId","required":true,"schema":{"description":"Harness Project ID","maxLength":128,"pattern":"^[A-Za-z_][A-Za-z0-9_]*$","type":"string"}},{"description":"Artifact target id","in":"path","name":"id","required":true,"schema":{"description":"Artifact target id","pattern":"^[a-zA-Z0-9_-]{22}$","type":"string"}},{"allowEmptyValue":true,"description":"Optional target variant id for version/tag scope","in":"query","name":"variantId","schema":{"description":"Optional target variant id for version/tag scope","pattern":"^[a-zA-Z0-9_-]{22}$","type":"string"}},{"allowEmptyValue":true,"description":"Case-insensitive substring match on effective digest (fingerprint or variant-name fallback)","in":"query","name":"search","schema":{"description":"Case-insensitive substring match on effective digest (fingerprint or variant-name fallback)","maxLength":256,"type":"string"}},{"allowEmptyValue":true,"description":"Page number to fetch (starting from 0)","in":"query","name":"page","schema":{"default":0,"description":"Page number to fetch (starting from 0)","format":"int64","minimum":0,"type":"integer"}},{"allowEmptyValue":true,"description":"Results per page","in":"query","name":"pageSize","schema":{"default":15,"description":"Results per page","format":"int64","maximum":100,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactsListArtifactDigestsResponseBody"}}},"description":"OK response."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}},"description":"BadRequest: Bad Request response."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}},"description":"Unauthorized: Unauthorized response."},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}},"description":"Forbidden: Forbidden response."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}},"description":"NotFound: Not Found response."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}},"description":"TooManyRequests: Too Many Requests response."},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}},"description":"InternalServerError: Internal Server Error response."}},"summary":"List an artifact target's digests","tags":["Artifacts"]}}}}
```

## Get artifact overview

> Artifact detail overview for the selected version (target variant): identity, latest-execution tiles, and per-digest severity matrix.

```json
{"openapi":"3.0.3","info":{"title":"Harness Security Test Orchestration API","version":"1.0.0"},"tags":[{"name":"Artifacts","description":"Read APIs for the Artifacts page."}],"servers":[{"url":"https://app.harness.io/gateway/sto"},{"url":"http://127.0.0.1:4000"}],"security":[{"jwt_header_Authorization":["sto_testtarget_view"]}],"components":{"securitySchemes":{"jwt_header_Authorization":{"type":"http","scheme":"bearer"}},"schemas":{"ArtifactsArtifactOverviewResponseBody":{"$ref":"#/components/schemas/ArtifactOverviewResult"},"ArtifactOverviewResult":{"type":"object","properties":{"baselineVariantId":{"type":"string","description":"Baseline variant id when set","pattern":"^([a-zA-Z0-9_-]{22}|)$"},"deployments":{"$ref":"#/components/schemas/ArtifactDeploymentCounts"},"digestFindingsMatrix":{"$ref":"#/components/schemas/ArtifactDigestFindingsMatrix"},"digests":{"type":"array","items":{"type":"string"},"description":"All distinct content digests for this version across succeeded scans, newest scanned first. Not capped; digestFindingsMatrix is a separate 5-row widget."},"executionId":{"type":"string","description":"CI execution identifier. With pipelineId and the request org/project, FE can construct a Harness execution URL when executionUrl is empty.","maxLength":128},"executionSource":{"type":"string","description":"CI/CD platform of the last execution (harness, jenkins, github_actions, gitlab_ci, ...). Distinct from artifact/repo registry source. Omitted when unknown.","maxLength":256},"executionUrl":{"type":"string","description":"Deep link from scan metadata (non-Harness). For Harness, often empty; FE constructs from pipelineId, executionId, and the request org/project.","maxLength":1024},"hasShiftLeftScan":{"type":"boolean","description":"True when cached ShiftLeft package counts exist for the scoped execution","default":false},"isBaseline":{"type":"boolean","description":"Whether the scoped version is the baseline"},"name":{"type":"string","description":"Artifact name"},"occurrenceSeverityCounts":{"$ref":"#/components/schemas/ArtifactSeverityCounts"},"pipelineId":{"type":"string","description":"Harness pipeline identifier (not the pretty pipelineName). Used with executionId to construct a Harness execution URL when executionUrl is empty.","maxLength":128},"registryUrl":{"type":"string","description":"Registry URL for the scoped version's latest execution. Omitted when unknown.","maxLength":1024},"sbomCount":{"type":"integer","description":"ShiftLeft/Qwiet package count (oss + container) for the scoped execution. 0 when unavailable.","format":"int64","minimum":0},"scannedAt":{"type":"integer","description":"Latest execution start time in milliseconds since Unix epoch","format":"int64"},"source":{"type":"string","description":"Artifact source for the scoped version's latest execution. Omitted when unknown. Values are snake_case: docker_hub, harness, aws_ecr, google, azure, github, jfrog_artifactory, docker_v2, local_image, local_archive.","maxLength":256},"targetId":{"type":"string","description":"Artifact target id"},"type":{"type":"string","description":"Target type","enum":["container","instance","configuration"]},"variantId":{"type":"string","description":"Scoped version id","pattern":"^[a-zA-Z0-9_-]{22}$"},"variantName":{"type":"string","description":"Version or tag name"},"versionsCount":{"type":"integer","description":"Number of scanned versions for this artifact","format":"int64","minimum":0}},"description":"Artifact detail overview for one version (target variant).","required":["targetId","name","type","versionsCount","isBaseline","digests","occurrenceSeverityCounts","sbomCount","hasShiftLeftScan","digestFindingsMatrix","deployments"]},"ArtifactDeploymentCounts":{"type":"object","properties":{"nonProd":{"type":"integer","description":"Instances whose env_type is not Production","format":"int64","minimum":0},"prod":{"type":"integer","description":"Instances whose env_type is Production","format":"int64","minimum":0},"total":{"type":"integer","description":"Live instances matching scanned digests","format":"int64","minimum":0}},"description":"Live CD instance counts from UDP cd:instance. Join is scan.artifact_fingerprint ↔ digest (STO hex plus sha256: prefix). Tags are not used. Prod is env_type Production; all other env_type values are nonProd.","required":["total","prod","nonProd"]},"ArtifactDigestFindingsMatrix":{"type":"object","properties":{"columnTotals":{"$ref":"#/components/schemas/ArtifactSeverityCounts"},"grandTotal":{"type":"integer","description":"CHML total across returned rows","format":"int64","minimum":0},"rows":{"type":"array","items":{"$ref":"#/components/schemas/ArtifactDigestMatrixRow"},"description":"Up to 5 unique digest/version labels, newest scanned first"}},"description":"Active findings by severity across unique content digests of a version. At most 5 rows, newest scanned first. Missing fingerprints collapse to one version-name row using the latest no-fingerprint execution only. Unassigned is always 0 (folded into info on execution_summary).","required":["rows","columnTotals","grandTotal"]},"ArtifactSeverityCounts":{"type":"object","properties":{"critical":{"type":"integer","description":"Critical count","format":"int64","minimum":0},"high":{"type":"integer","description":"High count","format":"int64","minimum":0},"info":{"type":"integer","description":"Info count","format":"int64","minimum":0},"low":{"type":"integer","description":"Low count","format":"int64","minimum":0},"medium":{"type":"integer","description":"Medium count","format":"int64","minimum":0},"unassigned":{"type":"integer","description":"Unassigned count","format":"int64","minimum":0}},"description":"Counts by severity.","required":["critical","high","medium","low","info","unassigned"]},"ArtifactDigestMatrixRow":{"type":"object","properties":{"digest":{"type":"string","description":"Content digest. Omitted when unavailable; a missing digest is the version-name row.","maxLength":256},"label":{"type":"string","description":"Unique display key: digest when present, otherwise the version name. At most one row per label."},"severityCounts":{"$ref":"#/components/schemas/ArtifactSeverityCounts"},"total":{"type":"integer","description":"CHML total (info and unassigned excluded)","format":"int64","minimum":0}},"description":"Severity counts for one unique content digest's latest succeeded execution, not a historical aggregate. Scans with no fingerprint share a single row whose label is the version name and whose counts come from the latest no-fingerprint execution only. Unassigned is 0; execution_summary folds unassigned into info.","required":["label","severityCounts","total"]},"NotFound":{"type":"object","properties":{"message":{"type":"string"},"status":{"type":"integer","default":404,"format":"int64"}},"required":["message"]}}},"paths":{"/api/v2/artifacts/{id}/overview":{"get":{"description":"Artifact detail overview for the selected version (target variant): identity, latest-execution tiles, and per-digest severity matrix.","operationId":"Artifacts#ArtifactOverview","parameters":[{"allowEmptyValue":true,"description":"Harness Account ID","in":"query","name":"accountId","required":true,"schema":{"description":"Harness Account ID","pattern":"^[a-zA-Z0-9_-]{22}$","type":"string"}},{"allowEmptyValue":true,"description":"Harness Organization ID","in":"query","name":"orgId","required":true,"schema":{"description":"Harness Organization ID","maxLength":128,"pattern":"^[A-Za-z_][A-Za-z0-9_]*$","type":"string"}},{"allowEmptyValue":true,"description":"Harness Project ID","in":"query","name":"projectId","required":true,"schema":{"description":"Harness Project ID","maxLength":128,"pattern":"^[A-Za-z_][A-Za-z0-9_]*$","type":"string"}},{"description":"Artifact target id","in":"path","name":"id","required":true,"schema":{"description":"Artifact target id","pattern":"^[a-zA-Z0-9_-]{22}$","type":"string"}},{"allowEmptyValue":true,"description":"Optional version scope; when omitted, uses the tracked version","in":"query","name":"variantId","schema":{"description":"Optional version scope; when omitted, uses the tracked version","pattern":"^[a-zA-Z0-9_-]{22}$","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactsArtifactOverviewResponseBody"}}},"description":"OK response."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}},"description":"BadRequest: Bad Request response."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}},"description":"Unauthorized: Unauthorized response."},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}},"description":"Forbidden: Forbidden response."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}},"description":"NotFound: Not Found response."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}},"description":"TooManyRequests: Too Many Requests response."},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}},"description":"InternalServerError: Internal Server Error response."}},"summary":"Get artifact overview","tags":["Artifacts"]}}}}
```

## Get an artifact's findings trend

> Per-execution occurrence severity counts (Findings Trend across Scans) for an artifact tag, same chart as the repository findings trend. Pass the lane (virtual baseline) variant id in targetVariantId to get the cross-tag baseline trend.

```json
{"openapi":"3.0.3","info":{"title":"Harness Security Test Orchestration API","version":"1.0.0"},"tags":[{"name":"Artifacts","description":"Read APIs for the Artifacts page."}],"servers":[{"url":"https://app.harness.io/gateway/sto"},{"url":"http://127.0.0.1:4000"}],"security":[{"jwt_header_Authorization":["sto_testtarget_view"]}],"components":{"securitySchemes":{"jwt_header_Authorization":{"type":"http","scheme":"bearer"}},"schemas":{"ArtifactsArtifactFindingsTrendResponseBody":{"$ref":"#/components/schemas/ExecutionTrendResult"},"ExecutionTrendResult":{"type":"object","properties":{"availableIssueTypes":{"type":"array","items":{"type":"string"},"description":"Distinct issue types present in the selected time range, before applying the issueTypes filter"},"trend":{"type":"array","items":{"$ref":"#/components/schemas/ExecutionTrendPoint"},"description":"Per-execution occurrence severity counts, ordered oldest to newest"}},"required":["trend","availableIssueTypes"]},"ExecutionTrendPoint":{"type":"object","properties":{"executionId":{"type":"string","description":"Harness execution ID"},"executionSource":{"type":"string","description":"Source/trigger of the execution"},"executionStartedAt":{"type":"integer","description":"Unix timestamp when the execution started","format":"int64"},"executionUrl":{"type":"string","description":"Deep link from scan metadata (non-Harness). For Harness, often empty; FE constructs from pipelineId, executionId, and the request org/project."},"issueTypes":{"type":"object","description":"Occurrence counts grouped by issue type (e.g. SAST, SCA, SECRET)","additionalProperties":{"type":"integer","format":"int64"}},"pipelineId":{"type":"string","description":"Harness pipeline identifier. Used with executionId and the request org/project to construct a Harness execution URL when executionUrl is empty.","maxLength":128},"severities":{"type":"object","description":"Occurrence counts grouped by severity (critical, high, medium, low, info)","additionalProperties":{"type":"integer","format":"int64"}}},"description":"Occurrence severity counts and metadata for a single execution","required":["executionId","executionStartedAt","severities","issueTypes"]},"NotFound":{"type":"object","properties":{"message":{"type":"string"},"status":{"type":"integer","default":404,"format":"int64"}},"required":["message"]}}},"paths":{"/api/v2/artifacts/{id}/trend/findings":{"get":{"description":"Per-execution occurrence severity counts (Findings Trend across Scans) for an artifact tag, same chart as the repository findings trend. Pass the lane (virtual baseline) variant id in targetVariantId to get the cross-tag baseline trend.","operationId":"Artifacts#ArtifactFindingsTrend","parameters":[{"allowEmptyValue":true,"description":"Harness Account ID","in":"query","name":"accountId","required":true,"schema":{"description":"Harness Account ID","pattern":"^[a-zA-Z0-9_-]{22}$","type":"string"}},{"allowEmptyValue":true,"description":"Harness Organization ID","in":"query","name":"orgId","required":true,"schema":{"description":"Harness Organization ID","maxLength":128,"pattern":"^[A-Za-z_][A-Za-z0-9_]*$","type":"string"}},{"allowEmptyValue":true,"description":"Harness Project ID","in":"query","name":"projectId","required":true,"schema":{"description":"Harness Project ID","maxLength":128,"pattern":"^[A-Za-z_][A-Za-z0-9_]*$","type":"string"}},{"description":"Artifact target id","in":"path","name":"id","required":true,"schema":{"description":"Artifact target id","pattern":"^[a-zA-Z0-9_-]{22}$","type":"string"}},{"allowEmptyValue":true,"description":"Associated Target Variant ID","in":"query","name":"targetVariantId","required":true,"schema":{"description":"Associated Target Variant ID","pattern":"^[a-zA-Z0-9_-]{22}$","type":"string"}},{"allowEmptyValue":true,"in":"query","name":"issueTypes","schema":{"pattern":"^(SAST|DAST|SCA|IAC|SECRET|MISCONFIG|BUG_SMELLS|CODE_SMELLS|CODE_COVERAGE|EXTERNAL_POLICY|UNKNOWN)(,SAST|,DAST|,SCA|,IAC|,SECRET|,MISCONFIG|,BUG_SMELLS|,CODE_SMELLS|,CODE_COVERAGE|,EXTERNAL_POLICY|,UNKNOWN)*$","type":"string"}},{"allowEmptyValue":true,"description":"Number of trailing days of executions to return","in":"query","name":"intervalDays","schema":{"default":30,"description":"Number of trailing days of executions to return","format":"int64","maximum":90,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactsArtifactFindingsTrendResponseBody"}}},"description":"OK response."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}},"description":"BadRequest: Bad Request response."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}},"description":"Unauthorized: Unauthorized response."},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}},"description":"Forbidden: Forbidden response."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}},"description":"NotFound: Not Found response."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}},"description":"TooManyRequests: Too Many Requests response."},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}},"description":"InternalServerError: Internal Server Error response."}},"summary":"Get an artifact's findings trend","tags":["Artifacts"]}}}}
```

## Get an artifact's remediation trend

> Per-execution cumulative new vs remediated occurrence counts for an artifact tag, same chart as the repository remediation trend. Pass the lane (virtual baseline) variant id in targetVariantId to get the cross-tag baseline trend.

```json
{"openapi":"3.0.3","info":{"title":"Harness Security Test Orchestration API","version":"1.0.0"},"tags":[{"name":"Artifacts","description":"Read APIs for the Artifacts page."}],"servers":[{"url":"https://app.harness.io/gateway/sto"},{"url":"http://127.0.0.1:4000"}],"security":[{"jwt_header_Authorization":["sto_testtarget_view"]}],"components":{"securitySchemes":{"jwt_header_Authorization":{"type":"http","scheme":"bearer"}},"schemas":{"ArtifactsArtifactRemediationTrendResponseBody":{"$ref":"#/components/schemas/RemediationTrendResult"},"RemediationTrendResult":{"type":"object","properties":{"trend":{"type":"array","items":{"$ref":"#/components/schemas/RemediationTrendPoint"},"description":"Per-execution cumulative discovered vs remediated occurrence counts, ordered by execution start oldest to newest"}},"required":["trend"]},"RemediationTrendPoint":{"type":"object","properties":{"cumulativeNew":{"type":"integer","description":"Cumulative discovered occurrences as of this execution's end","format":"int64"},"cumulativeRemediated":{"type":"integer","description":"Cumulative remediated occurrences as of this execution's end","format":"int64"},"executionId":{"type":"string","description":"Harness execution ID"},"timestamp":{"type":"string","description":"ISO-8601 timestamp when the execution started"}},"description":"Cumulative new vs remediated occurrence counts for a single execution","required":["executionId","timestamp","cumulativeNew","cumulativeRemediated"]},"NotFound":{"type":"object","properties":{"message":{"type":"string"},"status":{"type":"integer","default":404,"format":"int64"}},"required":["message"]}}},"paths":{"/api/v2/artifacts/{id}/trend/remediation":{"get":{"description":"Per-execution cumulative new vs remediated occurrence counts for an artifact tag, same chart as the repository remediation trend. Pass the lane (virtual baseline) variant id in targetVariantId to get the cross-tag baseline trend.","operationId":"Artifacts#ArtifactRemediationTrend","parameters":[{"allowEmptyValue":true,"description":"Harness Account ID","in":"query","name":"accountId","required":true,"schema":{"description":"Harness Account ID","pattern":"^[a-zA-Z0-9_-]{22}$","type":"string"}},{"allowEmptyValue":true,"description":"Harness Organization ID","in":"query","name":"orgId","required":true,"schema":{"description":"Harness Organization ID","maxLength":128,"pattern":"^[A-Za-z_][A-Za-z0-9_]*$","type":"string"}},{"allowEmptyValue":true,"description":"Harness Project ID","in":"query","name":"projectId","required":true,"schema":{"description":"Harness Project ID","maxLength":128,"pattern":"^[A-Za-z_][A-Za-z0-9_]*$","type":"string"}},{"description":"Artifact target id","in":"path","name":"id","required":true,"schema":{"description":"Artifact target id","pattern":"^[a-zA-Z0-9_-]{22}$","type":"string"}},{"allowEmptyValue":true,"description":"Associated Target Variant ID","in":"query","name":"targetVariantId","schema":{"description":"Associated Target Variant ID","pattern":"^[a-zA-Z0-9_-]{22}$","type":"string"}},{"allowEmptyValue":true,"description":"Number of days to fetch trend data for","in":"query","name":"intervalDays","schema":{"default":30,"description":"Number of days to fetch trend data for","format":"int64","maximum":90,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactsArtifactRemediationTrendResponseBody"}}},"description":"OK response."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}},"description":"BadRequest: Bad Request response."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}},"description":"Unauthorized: Unauthorized response."},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}},"description":"Forbidden: Forbidden response."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}},"description":"NotFound: Not Found response."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}},"description":"TooManyRequests: Too Many Requests response."},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}},"description":"InternalServerError: Internal Server Error response."}},"summary":"Get an artifact's remediation trend","tags":["Artifacts"]}}}}
```

## List an artifact's scanned versions

> List scanned versions for an artifact, newest first. Optional search matches version name or exact variant id.

```json
{"openapi":"3.0.3","info":{"title":"Harness Security Test Orchestration API","version":"1.0.0"},"tags":[{"name":"Artifacts","description":"Read APIs for the Artifacts page."}],"servers":[{"url":"https://app.harness.io/gateway/sto"},{"url":"http://127.0.0.1:4000"}],"security":[{"jwt_header_Authorization":["sto_testtarget_view"]}],"components":{"securitySchemes":{"jwt_header_Authorization":{"type":"http","scheme":"bearer"}},"schemas":{"ArtifactsListArtifactVariantsResponseBody":{"type":"object","properties":{"pagination":{"$ref":"#/components/schemas/Pagination"},"results":{"type":"array","items":{"$ref":"#/components/schemas/TargetVariant"}}},"required":["results","pagination"]},"Pagination":{"type":"object","properties":{"link":{"type":"string","description":"Link-based paging"},"page":{"type":"integer","description":"Page number (starting from 0)","format":"int64"},"pageSize":{"type":"integer","description":"Requested page size","format":"int64"},"totalItems":{"type":"integer","description":"Total results available","format":"int64"},"totalPages":{"type":"integer","description":"Total pages available","format":"int64"}},"required":["page","pageSize","totalPages","totalItems"]},"TargetVariant":{"type":"object","properties":{"created":{"type":"integer","description":"Unix timestamp at which the resource was created","format":"int64"},"hash":{"type":"string","description":"Git Commit or Container Image hash","maxLength":64},"id":{"type":"string","description":"Resource identifier","pattern":"^[a-zA-Z0-9_-]{22}$"},"isVirtualBaseline":{"type":"boolean","description":"True for the virtual baseline lane entry (one per target, collects every baseline scan across tags). For the lane, parameters.variant holds the current physical tag. Absent/false for real tags and branches."},"lastModified":{"type":"integer","description":"Unix timestamp at which the resource was most recently modified","format":"int64"},"parameters":{"type":"object","description":"Parameters for this Variant, as a JSON-encoded string","additionalProperties":{"type":"string"}},"targetId":{"type":"string","description":"Associated Target ID","pattern":"^[a-zA-Z0-9_-]{22}$"}},"description":"Information about a Scan Target Variant","required":["targetId","parameters","id","created","lastModified"]},"NotFound":{"type":"object","properties":{"message":{"type":"string"},"status":{"type":"integer","default":404,"format":"int64"}},"required":["message"]}}},"paths":{"/api/v2/artifacts/{id}/variants":{"get":{"description":"List scanned versions for an artifact, newest first. Optional search matches version name or exact variant id.","operationId":"Artifacts#ListArtifactVariants","parameters":[{"allowEmptyValue":true,"description":"Harness Account ID","in":"query","name":"accountId","required":true,"schema":{"description":"Harness Account ID","pattern":"^[a-zA-Z0-9_-]{22}$","type":"string"}},{"allowEmptyValue":true,"description":"Harness Organization ID","in":"query","name":"orgId","required":true,"schema":{"description":"Harness Organization ID","maxLength":128,"pattern":"^[A-Za-z_][A-Za-z0-9_]*$","type":"string"}},{"allowEmptyValue":true,"description":"Harness Project ID","in":"query","name":"projectId","required":true,"schema":{"description":"Harness Project ID","maxLength":128,"pattern":"^[A-Za-z_][A-Za-z0-9_]*$","type":"string"}},{"description":"Artifact target id","in":"path","name":"id","required":true,"schema":{"description":"Artifact target id","pattern":"^[a-zA-Z0-9_-]{22}$","type":"string"}},{"allowEmptyValue":true,"description":"Case-insensitive version name substring, or exact variant id","in":"query","name":"search","schema":{"description":"Case-insensitive version name substring, or exact variant id","maxLength":256,"type":"string"}},{"allowEmptyValue":true,"description":"Page number to fetch (starting from 0)","in":"query","name":"page","schema":{"default":0,"description":"Page number to fetch (starting from 0)","format":"int64","minimum":0,"type":"integer"}},{"allowEmptyValue":true,"description":"Results per page","in":"query","name":"pageSize","schema":{"default":10,"description":"Results per page","format":"int64","maximum":100,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactsListArtifactVariantsResponseBody"}}},"description":"OK response."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}},"description":"BadRequest: Bad Request response."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}},"description":"Unauthorized: Unauthorized response."},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}},"description":"Forbidden: Forbidden response."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}},"description":"NotFound: Not Found response."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}},"description":"TooManyRequests: Too Many Requests response."},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}},"description":"InternalServerError: Internal Server Error response."}},"summary":"List an artifact's scanned versions","tags":["Artifacts"]}}}}
```

## Get artifacts overview

> Aggregate widgets for the Artifacts page.

```json
{"openapi":"3.0.3","info":{"title":"Harness Security Test Orchestration API","version":"1.0.0"},"tags":[{"name":"Artifacts","description":"Read APIs for the Artifacts page."}],"servers":[{"url":"https://app.harness.io/gateway/sto"},{"url":"http://127.0.0.1:4000"}],"security":[{"jwt_header_Authorization":["sto_testtarget_view"]}],"components":{"securitySchemes":{"jwt_header_Authorization":{"type":"http","scheme":"bearer"}},"schemas":{"ArtifactsArtifactsOverviewResponseBody":{"$ref":"#/components/schemas/ArtifactsOverviewResult"},"ArtifactsOverviewResult":{"type":"object","properties":{"baselineSet":{"type":"integer","description":"Artifacts with a baseline set","format":"int64","minimum":0},"deployments":{"$ref":"#/components/schemas/ArtifactDeploymentCounts"},"exploitRisk":{"type":"integer","description":"Exploit Risk tile: critical-severity slice of fixAvailable. JSON key is exploitRisk (UI label: Exploit Risk).","format":"int64","minimum":0},"fixAvailable":{"type":"integer","description":"Sum of scanner-fix-available findings across severities (upgrade/fixed version or scanner remediation steps). Excludes Harness AI remediations.","format":"int64","minimum":0},"issueRemediations":{"type":"integer","description":"Change in remediated issues since UTC midnight","format":"int64"},"issueSeverityDeltas":{"$ref":"#/components/schemas/ArtifactSeverityDeltas"},"issueSeverityTotals":{"$ref":"#/components/schemas/ArtifactSeverityCounts"},"occurrenceRemediations":{"type":"integer","description":"Change in remediated occurrences since UTC midnight","format":"int64"},"occurrenceSeverityDeltas":{"$ref":"#/components/schemas/ArtifactSeverityDeltas"},"occurrenceSeverityTotals":{"$ref":"#/components/schemas/ArtifactSeverityCounts"},"sourceBreakdown":{"type":"array","items":{"$ref":"#/components/schemas/ArtifactSourceBreakdownItem"},"description":"Artifact counts grouped by artifact source. Null/empty artifact_source is grouped as Unknown."},"totalArtifacts":{"type":"integer","description":"Total artifacts","format":"int64","minimum":0}},"description":"Aggregate widgets for the Artifacts page.","required":["totalArtifacts","sourceBreakdown","baselineSet","occurrenceSeverityTotals","issueSeverityTotals","fixAvailable","exploitRisk","deployments"]},"ArtifactDeploymentCounts":{"type":"object","properties":{"nonProd":{"type":"integer","description":"Instances whose env_type is not Production","format":"int64","minimum":0},"prod":{"type":"integer","description":"Instances whose env_type is Production","format":"int64","minimum":0},"total":{"type":"integer","description":"Live instances matching scanned digests","format":"int64","minimum":0}},"description":"Live CD instance counts from UDP cd:instance. Join is scan.artifact_fingerprint ↔ digest (STO hex plus sha256: prefix). Tags are not used. Prod is env_type Production; all other env_type values are nonProd.","required":["total","prod","nonProd"]},"ArtifactSeverityDeltas":{"type":"object","properties":{"critical":{"type":"integer","description":"Change in critical count","format":"int64"},"high":{"type":"integer","description":"Change in high count","format":"int64"},"info":{"type":"integer","description":"Change in info count","format":"int64"},"low":{"type":"integer","description":"Change in low count","format":"int64"},"medium":{"type":"integer","description":"Change in medium count","format":"int64"},"unassigned":{"type":"integer","description":"Change in unassigned count","format":"int64"}},"description":"Change in counts by severity since UTC midnight. May be negative. Null when no snapshot exists for today.","required":["critical","high","medium","low","info","unassigned"]},"ArtifactSeverityCounts":{"type":"object","properties":{"critical":{"type":"integer","description":"Critical count","format":"int64","minimum":0},"high":{"type":"integer","description":"High count","format":"int64","minimum":0},"info":{"type":"integer","description":"Info count","format":"int64","minimum":0},"low":{"type":"integer","description":"Low count","format":"int64","minimum":0},"medium":{"type":"integer","description":"Medium count","format":"int64","minimum":0},"unassigned":{"type":"integer","description":"Unassigned count","format":"int64","minimum":0}},"description":"Counts by severity.","required":["critical","high","medium","low","info","unassigned"]},"ArtifactSourceBreakdownItem":{"type":"object","properties":{"count":{"type":"integer","description":"Count","format":"int64","minimum":0},"source":{"type":"string","description":"Artifact source. Unknown when artifact_source is null or empty."}},"description":"Count of artifacts for one artifact source.","required":["source","count"]},"NotFound":{"type":"object","properties":{"message":{"type":"string"},"status":{"type":"integer","default":404,"format":"int64"}},"required":["message"]}}},"paths":{"/api/v2/artifacts/overview":{"get":{"description":"Aggregate widgets for the Artifacts page.","operationId":"Artifacts#ArtifactsOverview","parameters":[{"allowEmptyValue":true,"description":"Harness Account ID","in":"query","name":"accountId","required":true,"schema":{"description":"Harness Account ID","pattern":"^[a-zA-Z0-9_-]{22}$","type":"string"}},{"allowEmptyValue":true,"description":"Harness Organization ID","in":"query","name":"orgId","required":true,"schema":{"description":"Harness Organization ID","maxLength":128,"pattern":"^[A-Za-z_][A-Za-z0-9_]*$","type":"string"}},{"allowEmptyValue":true,"description":"Harness Project ID","in":"query","name":"projectId","required":true,"schema":{"description":"Harness Project ID","maxLength":128,"pattern":"^[A-Za-z_][A-Za-z0-9_]*$","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactsArtifactsOverviewResponseBody"}}},"description":"OK response."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}},"description":"BadRequest: Bad Request response."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}},"description":"Unauthorized: Unauthorized response."},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}},"description":"Forbidden: Forbidden response."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}},"description":"NotFound: Not Found response."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}},"description":"TooManyRequests: Too Many Requests response."},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}},"description":"InternalServerError: Internal Server Error response."}},"summary":"Get artifacts overview","tags":["Artifacts"]}}}}
```
