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

# Applications

User-created groups of already-scanned targets in one project

## List applications

> List applications in a project. Counts, findings, scan types, and last scan are read from each member scoreboard.

```json
{"openapi":"3.0.3","info":{"title":"Harness Security Test Orchestration API","version":"1.0.0"},"tags":[{"name":"Applications","description":"User-created groups of already-scanned targets in one project"}],"servers":[{"url":"https://app.harness.io/gateway/sto"},{"url":"http://127.0.0.1:4000"}],"security":[{"X-Api-Key_header_X-Api-Key":[],"jwt_header_Authorization":["sto_testtarget_view"]}],"components":{"securitySchemes":{"X-Api-Key_header_X-Api-Key":{"type":"apiKey","name":"X-Api-Key","in":"header"},"jwt_header_Authorization":{"type":"http","scheme":"bearer"}},"schemas":{"ApplicationsListApplicationsResponseBody":{"type":"object","properties":{"pagination":{"$ref":"#/components/schemas/Pagination"},"results":{"type":"array","items":{"$ref":"#/components/schemas/ApplicationListItem"},"description":"One page of applications"}},"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"]},"ApplicationListItem":{"type":"object","properties":{"artifactCount":{"type":"integer","description":"Counted members of type container","format":"int64","minimum":0},"id":{"type":"string","description":"Application id","pattern":"^[a-zA-Z0-9_-]{22}$"},"lastScanAt":{"type":"integer","description":"Newest member last-scan time in milliseconds since Unix epoch. Omitted when every member has no last scan.","format":"int64"},"name":{"type":"string","description":"Application name"},"occurrenceNewDelta":{"type":"integer","description":"Sum, across counted members, of each member's cumulative_open_occurrences_count vs that member's previous execution of its tracked variant. Findings 'new' delta, labeled 'last 24h' in the UI like Code Repos, though the comparison is since each member's previous scan, not a fixed time window. A member with no previous execution does not contribute. Omitted when no counted member has one.","format":"int64"},"occurrenceRemediatedDelta":{"type":"integer","description":"Sum, across counted members, of each member's cumulative_remediated_occurrences_count vs that member's previous execution of its tracked variant. Findings 'remediated' delta, same caveats as occurrenceNewDelta.","format":"int64"},"occurrenceSeverityCounts":{"$ref":"#/components/schemas/ArtifactSeverityCounts"},"repositoryCount":{"type":"integer","description":"Counted members of type repository","format":"int64","minimum":0},"scanType":{"type":"object","description":"Scan types on this application's counted members mapped to scanner ids and display names. Keys match scanTypes.","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/ScanTypeScanner"}}},"scanTypes":{"type":"array","items":{"type":"string"},"description":"Distinct scan types that appear on this application's counted members, sorted by name. A type that was never scanned is omitted."},"targetCount":{"type":"integer","description":"Counted members","format":"int64","minimum":0}},"description":"One applications-table row. Counts are unique inside the application.","required":["id","name","targetCount","repositoryCount","artifactCount","scanTypes","occurrenceSeverityCounts"]},"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/applications":{"get":{"tags":["Applications"],"summary":"List applications","description":"List applications in a project. Counts, findings, scan types, and last scan are read from each member scoreboard.","operationId":"Applications#ListApplications","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":"page","in":"query","description":"Page number to fetch, starting from 0","allowEmptyValue":true,"schema":{"type":"integer","description":"Page number to fetch, starting from 0","default":0,"format":"int64","minimum":0}},{"name":"pageSize","in":"query","description":"Results per page","allowEmptyValue":true,"schema":{"type":"integer","description":"Results per page","default":10,"format":"int64","minimum":1,"maximum":100}},{"name":"search","in":"query","description":"Case-insensitive application name substring","allowEmptyValue":true,"schema":{"type":"string","description":"Case-insensitive application name substring","maxLength":256}},{"name":"sort","in":"query","description":"Sort field","allowEmptyValue":true,"schema":{"type":"string","description":"Sort field","default":"lastScanAt","enum":["lastScanAt","severity","targetCount"]}},{"name":"order","in":"query","description":"Sort direction","allowEmptyValue":true,"schema":{"type":"string","description":"Sort direction","default":"DESC","enum":["ASC","DESC"]}},{"name":"severity","in":"query","description":"Comma-separated severities. Keeps an application whose summed occurrence count for any listed severity is greater than 0.","allowEmptyValue":true,"schema":{"type":"string","description":"Comma-separated severities. Keeps an application whose summed occurrence count for any listed severity is greater than 0.","pattern":"^((critical|high|medium|low|info|unassigned)(,(critical|high|medium|low|info|unassigned))*)?$"}},{"name":"scanTypes","in":"query","description":"Comma-separated scan types. Keeps an application whose member scan types overlap this list.","allowEmptyValue":true,"schema":{"type":"string","description":"Comma-separated scan types. Keeps an application whose member scan types overlap this list.","pattern":"^([^,]+(,[^,]+)*)?$","maxLength":256}},{"name":"scanners","in":"query","description":"Comma-separated scanner product names. Keeps an application whose member targets' scanners overlap this list.","allowEmptyValue":true,"schema":{"type":"string","description":"Comma-separated scanner product names. Keeps an application whose member targets' scanners overlap this list.","pattern":"^([^,]+(,[^,]+)*)?$","maxLength":256}},{"name":"businessCriticality","in":"query","description":"Comma-separated true/false. Keeps an application whose businessCriticality matches any listed value.","allowEmptyValue":true,"schema":{"type":"string","description":"Comma-separated true/false. Keeps an application whose businessCriticality matches any listed value.","pattern":"^((true|false)(,(true|false))*)?$"}},{"name":"deploymentEnvironment","in":"query","description":"Comma-separated deployment environments. Keeps an application whose deploymentEnvironment matches any listed value. Applications with deploymentEnvironment unset are excluded when this filter is set.","allowEmptyValue":true,"schema":{"type":"string","description":"Comma-separated deployment environments. Keeps an application whose deploymentEnvironment matches any listed value. Applications with deploymentEnvironment unset are excluded when this filter is set.","pattern":"^((Production|Pre-production|Development)(,(Production|Pre-production|Development))*)?$"}},{"name":"internetExposure","in":"query","description":"Comma-separated true/false. Keeps an application whose internetExposure matches any listed value. Applications with internetExposure unset are excluded when this filter is set.","allowEmptyValue":true,"schema":{"type":"string","description":"Comma-separated true/false. Keeps an application whose internetExposure matches any listed value. Applications with internetExposure unset are excluded when this filter is set.","pattern":"^((true|false)(,(true|false))*)?$"}},{"name":"dataSensitivity","in":"query","description":"Comma-separated true/false. Keeps an application whose dataSensitivity matches any listed value. Applications with dataSensitivity unset are excluded when this filter is set.","allowEmptyValue":true,"schema":{"type":"string","description":"Comma-separated true/false. Keeps an application whose dataSensitivity matches any listed value. Applications with dataSensitivity unset are excluded when this filter is set.","pattern":"^((true|false)(,(true|false))*)?$"}},{"name":"X-Api-Key","in":"header","description":"Harness personal or service access token","allowEmptyValue":true,"schema":{"type":"string","description":"Harness personal or service access token"}}],"responses":{"200":{"description":"OK response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplicationsListApplicationsResponseBody"}}}},"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"}}}}}}}}}
```

## Create an application

> Create an application and its members in one transaction. Does not start a scan.

```json
{"openapi":"3.0.3","info":{"title":"Harness Security Test Orchestration API","version":"1.0.0"},"tags":[{"name":"Applications","description":"User-created groups of already-scanned targets in one project"}],"servers":[{"url":"https://app.harness.io/gateway/sto"},{"url":"http://127.0.0.1:4000"}],"security":[{"X-Api-Key_header_X-Api-Key":[],"jwt_header_Authorization":["sto_testtarget_edit"]}],"components":{"securitySchemes":{"X-Api-Key_header_X-Api-Key":{"type":"apiKey","name":"X-Api-Key","in":"header"},"jwt_header_Authorization":{"type":"http","scheme":"bearer"}},"schemas":{"CreateApplicationRequestBody":{"type":"object","properties":{"businessCriticality":{"type":"boolean","description":"Whether the application is business critical"},"dataSensitivity":{"type":"boolean","description":"Whether the application contains sensitive data. Omitted means unset."},"deploymentEnvironment":{"type":"string","description":"Deployment environment. Omitted means unset.","enum":["Production","Pre-production","Development"]},"internetExposure":{"type":"boolean","description":"Whether the application is internet exposed. Omitted means unset."},"name":{"type":"string","description":"Application name. Unique among live applications in the project.","minLength":1,"maxLength":128},"targetIds":{"type":"array","items":{"type":"string","pattern":"^[a-zA-Z0-9_-]{22}$"},"description":"Scanned target ids in this project. Minimum 1, maximum 100, no duplicates.","minItems":1,"maxItems":100}},"required":["name","businessCriticality","targetIds"]},"ExemptionRulesCreateExemptionRuleResponseBody":{"$ref":"#/components/schemas/IDResult"},"IDResult":{"type":"object","properties":{"id":{"type":"string","description":"Resource identifier","pattern":"^[a-zA-Z0-9_-]{22}$"}},"required":["id"]},"NotFound":{"type":"object","properties":{"message":{"type":"string"},"status":{"type":"integer","default":404,"format":"int64"}},"required":["message"]}}},"paths":{"/api/v2/applications":{"post":{"tags":["Applications"],"summary":"Create an application","description":"Create an application and its members in one transaction. Does not start a scan.","operationId":"Applications#CreateApplication","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":"X-Api-Key","in":"header","description":"Harness personal or service access token","allowEmptyValue":true,"schema":{"type":"string","description":"Harness personal or service access token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateApplicationRequestBody"}}}},"responses":{"200":{"description":"OK response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExemptionRulesCreateExemptionRuleResponseBody"}}}},"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"}}}}}}}}}
```

## Get an application

> Load one live application and its current members.

```json
{"openapi":"3.0.3","info":{"title":"Harness Security Test Orchestration API","version":"1.0.0"},"tags":[{"name":"Applications","description":"User-created groups of already-scanned targets in one project"}],"servers":[{"url":"https://app.harness.io/gateway/sto"},{"url":"http://127.0.0.1:4000"}],"security":[{"X-Api-Key_header_X-Api-Key":[],"jwt_header_Authorization":["sto_testtarget_view"]}],"components":{"securitySchemes":{"X-Api-Key_header_X-Api-Key":{"type":"apiKey","name":"X-Api-Key","in":"header"},"jwt_header_Authorization":{"type":"http","scheme":"bearer"}},"schemas":{"ApplicationsFindApplicationByIDResponseBody":{"$ref":"#/components/schemas/Application"},"Application":{"type":"object","properties":{"businessCriticality":{"type":"boolean","description":"Whether the application is business critical"},"created":{"type":"integer","description":"Unix timestamp at which the resource was created","format":"int64"},"createdBy":{"type":"string","description":"Principal that created the application"},"dataSensitivity":{"type":"boolean","description":"Whether the application contains sensitive data. Omitted when unset."},"deploymentEnvironment":{"type":"string","description":"Deployment environment. Omitted when unset.","enum":["Production","Pre-production","Development"]},"id":{"type":"string","description":"Application id","pattern":"^[a-zA-Z0-9_-]{22}$"},"internetExposure":{"type":"boolean","description":"Whether the application is internet exposed. Omitted when unset."},"lastModified":{"type":"integer","description":"Unix timestamp at which the resource was most recently modified","format":"int64"},"lastModifiedBy":{"type":"string","description":"Principal that last modified the application"},"name":{"type":"string","description":"Application name"},"targets":{"type":"array","items":{"$ref":"#/components/schemas/ApplicationTarget"},"description":"Live members. Soft-deleted targets are omitted."}},"description":"A named group of scanned targets in one project.","required":["id","name","businessCriticality","targets","createdBy","lastModifiedBy","created","lastModified"]},"ApplicationTarget":{"type":"object","properties":{"defaultRef":{"type":"string","description":"Baseline variant name. Omitted when the target has no baseline."},"id":{"type":"string","description":"Target id","pattern":"^[a-zA-Z0-9_-]{22}$"},"name":{"type":"string","description":"Target name"},"type":{"type":"string","description":"Target type. repository or container."}},"description":"A member target. defaultRef is the baseline variant name, read from the target.","required":["id","name","type"]},"NotFound":{"type":"object","properties":{"message":{"type":"string"},"status":{"type":"integer","default":404,"format":"int64"}},"required":["message"]}}},"paths":{"/api/v2/applications/{id}":{"get":{"tags":["Applications"],"summary":"Get an application","description":"Load one live application and its current members.","operationId":"Applications#FindApplicationByID","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":"id","in":"path","description":"Application id","required":true,"schema":{"type":"string","description":"Application id","pattern":"^[a-zA-Z0-9_-]{22}$"}},{"name":"X-Api-Key","in":"header","description":"Harness personal or service access token","allowEmptyValue":true,"schema":{"type":"string","description":"Harness personal or service access token"}}],"responses":{"200":{"description":"OK response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplicationsFindApplicationByIDResponseBody"}}}},"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"}}}}}}}}}
```

## Delete an application

> Soft-delete an application. Member targets and their scans stay.

```json
{"openapi":"3.0.3","info":{"title":"Harness Security Test Orchestration API","version":"1.0.0"},"tags":[{"name":"Applications","description":"User-created groups of already-scanned targets in one project"}],"servers":[{"url":"https://app.harness.io/gateway/sto"},{"url":"http://127.0.0.1:4000"}],"security":[{"jwt_header_Authorization":["sto_testtarget_edit"]}],"components":{"securitySchemes":{"jwt_header_Authorization":{"type":"http","scheme":"bearer"}},"schemas":{"NotFound":{"type":"object","properties":{"message":{"type":"string"},"status":{"type":"integer","default":404,"format":"int64"}},"required":["message"]}}},"paths":{"/api/v2/applications/{id}":{"delete":{"tags":["Applications"],"summary":"Delete an application","description":"Soft-delete an application. Member targets and their scans stay.","operationId":"Applications#DeleteApplication","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":"id","in":"path","description":"Application id","required":true,"schema":{"type":"string","description":"Application id","pattern":"^[a-zA-Z0-9_-]{22}$"}}],"responses":{"200":{"description":"OK response."},"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"}}}}}}}}}
```

## Patch an application

> Patch name and replace members in one transaction. Risk fields are not changed by this endpoint. Does not start a scan.

```json
{"openapi":"3.0.3","info":{"title":"Harness Security Test Orchestration API","version":"1.0.0"},"tags":[{"name":"Applications","description":"User-created groups of already-scanned targets in one project"}],"servers":[{"url":"https://app.harness.io/gateway/sto"},{"url":"http://127.0.0.1:4000"}],"security":[{"X-Api-Key_header_X-Api-Key":[],"jwt_header_Authorization":["sto_testtarget_edit"]}],"components":{"securitySchemes":{"X-Api-Key_header_X-Api-Key":{"type":"apiKey","name":"X-Api-Key","in":"header"},"jwt_header_Authorization":{"type":"http","scheme":"bearer"}},"schemas":{"PatchApplicationRequestBody":{"type":"object","properties":{"name":{"type":"string","description":"Application name. Unique among live applications in the project.","minLength":1,"maxLength":128},"targetIds":{"type":"array","items":{"type":"string","pattern":"^[a-zA-Z0-9_-]{22}$"},"description":"Scanned target ids for this application after the update. Minimum 1, maximum 100, no duplicates.","minItems":1,"maxItems":100}},"required":["name","targetIds"]},"ApplicationsFindApplicationByIDResponseBody":{"$ref":"#/components/schemas/Application"},"Application":{"type":"object","properties":{"businessCriticality":{"type":"boolean","description":"Whether the application is business critical"},"created":{"type":"integer","description":"Unix timestamp at which the resource was created","format":"int64"},"createdBy":{"type":"string","description":"Principal that created the application"},"dataSensitivity":{"type":"boolean","description":"Whether the application contains sensitive data. Omitted when unset."},"deploymentEnvironment":{"type":"string","description":"Deployment environment. Omitted when unset.","enum":["Production","Pre-production","Development"]},"id":{"type":"string","description":"Application id","pattern":"^[a-zA-Z0-9_-]{22}$"},"internetExposure":{"type":"boolean","description":"Whether the application is internet exposed. Omitted when unset."},"lastModified":{"type":"integer","description":"Unix timestamp at which the resource was most recently modified","format":"int64"},"lastModifiedBy":{"type":"string","description":"Principal that last modified the application"},"name":{"type":"string","description":"Application name"},"targets":{"type":"array","items":{"$ref":"#/components/schemas/ApplicationTarget"},"description":"Live members. Soft-deleted targets are omitted."}},"description":"A named group of scanned targets in one project.","required":["id","name","businessCriticality","targets","createdBy","lastModifiedBy","created","lastModified"]},"ApplicationTarget":{"type":"object","properties":{"defaultRef":{"type":"string","description":"Baseline variant name. Omitted when the target has no baseline."},"id":{"type":"string","description":"Target id","pattern":"^[a-zA-Z0-9_-]{22}$"},"name":{"type":"string","description":"Target name"},"type":{"type":"string","description":"Target type. repository or container."}},"description":"A member target. defaultRef is the baseline variant name, read from the target.","required":["id","name","type"]},"NotFound":{"type":"object","properties":{"message":{"type":"string"},"status":{"type":"integer","default":404,"format":"int64"}},"required":["message"]}}},"paths":{"/api/v2/applications/{id}":{"patch":{"tags":["Applications"],"summary":"Patch an application","description":"Patch name and replace members in one transaction. Risk fields are not changed by this endpoint. Does not start a scan.","operationId":"Applications#PatchApplication","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":"id","in":"path","description":"Application id","required":true,"schema":{"type":"string","description":"Application id","pattern":"^[a-zA-Z0-9_-]{22}$"}},{"name":"X-Api-Key","in":"header","description":"Harness personal or service access token","allowEmptyValue":true,"schema":{"type":"string","description":"Harness personal or service access token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchApplicationRequestBody"}}}},"responses":{"200":{"description":"OK response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplicationsFindApplicationByIDResponseBody"}}}},"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"}}}}}}}}}
```

## Get an application overview

> One application's list-row scoreboard. Target counts, scan types, and findings are unique inside this application.

```json
{"openapi":"3.0.3","info":{"title":"Harness Security Test Orchestration API","version":"1.0.0"},"tags":[{"name":"Applications","description":"User-created groups of already-scanned targets in one project"}],"servers":[{"url":"https://app.harness.io/gateway/sto"},{"url":"http://127.0.0.1:4000"}],"security":[{"X-Api-Key_header_X-Api-Key":[],"jwt_header_Authorization":["sto_testtarget_view"]}],"components":{"securitySchemes":{"X-Api-Key_header_X-Api-Key":{"type":"apiKey","name":"X-Api-Key","in":"header"},"jwt_header_Authorization":{"type":"http","scheme":"bearer"}},"schemas":{"ApplicationsApplicationOverviewResponseBody":{"$ref":"#/components/schemas/ApplicationOverviewResult"},"ApplicationOverviewResult":{"type":"object","properties":{"artifactCount":{"type":"integer","description":"Counted members of type container","format":"int64","minimum":0},"id":{"type":"string","description":"Application id","pattern":"^[a-zA-Z0-9_-]{22}$"},"issueFindingsMatrix":{"$ref":"#/components/schemas/TargetFindingsMatrix"},"lastScanAt":{"type":"integer","description":"Newest member last-scan time in milliseconds since Unix epoch. Omitted when every member has no last scan.","format":"int64"},"name":{"type":"string","description":"Application name"},"occurrenceFindingsMatrix":{"$ref":"#/components/schemas/TargetFindingsMatrix"},"occurrenceNewDelta":{"type":"integer","description":"Sum, across counted members, of each member's cumulative_open_occurrences_count vs that member's previous execution of its tracked variant. Findings 'new' delta, labeled 'last 24h' in the UI like Code Repos, though the comparison is since each member's previous scan, not a fixed time window. A member with no previous execution does not contribute. Omitted when no counted member has one.","format":"int64"},"occurrenceRemediatedDelta":{"type":"integer","description":"Sum, across counted members, of each member's cumulative_remediated_occurrences_count vs that member's previous execution of its tracked variant. Findings 'remediated' delta, same caveats as occurrenceNewDelta.","format":"int64"},"occurrenceSeverityCounts":{"$ref":"#/components/schemas/ArtifactSeverityCounts"},"repositoryCount":{"type":"integer","description":"Counted members of type repository","format":"int64","minimum":0},"scanType":{"type":"object","description":"Scan types on this application's counted members mapped to scanner ids and display names. Keys match scanTypes.","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/ScanTypeScanner"}}},"scanTypes":{"type":"array","items":{"type":"string"},"description":"Distinct scan types that appear on this application's counted members, sorted by name. A type that was never scanned is omitted."},"targetCount":{"type":"integer","description":"Counted members","format":"int64","minimum":0}},"description":"One application's list-row scoreboard plus the findings matrix over its counted members.","required":["id","name","targetCount","repositoryCount","artifactCount","scanTypes","occurrenceSeverityCounts","occurrenceFindingsMatrix","issueFindingsMatrix"]},"TargetFindingsMatrix":{"type":"object","properties":{"columnTotals":{"$ref":"#/components/schemas/RepositorySeverityCounts"},"grandTotal":{"type":"integer","description":"Sum of all cells","format":"int64","minimum":0},"rows":{"type":"array","items":{"$ref":"#/components/schemas/TargetFindingsMatrixRow"},"description":"One row per issue type"}},"description":"Cross-tab of counts by issue type and severity, with column totals and grand total.","required":["rows","columnTotals","grandTotal"]},"RepositorySeverityCounts":{"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"]},"TargetFindingsMatrixRow":{"type":"object","properties":{"issueType":{"type":"string","description":"Issue/scan type (e.g. SAST, SCA, SECRET)"},"severityCounts":{"$ref":"#/components/schemas/RepositorySeverityCounts"},"total":{"type":"integer","description":"Row total (sum of severity buckets)","format":"int64","minimum":0}},"description":"Findings or issues for one issue type, broken down by severity.","required":["issueType","severityCounts","total"]},"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/applications/{id}/overview":{"get":{"tags":["Applications"],"summary":"Get an application overview","description":"One application's list-row scoreboard. Target counts, scan types, and findings are unique inside this application.","operationId":"Applications#ApplicationOverview","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":"id","in":"path","description":"Application id","required":true,"schema":{"type":"string","description":"Application id","pattern":"^[a-zA-Z0-9_-]{22}$"}},{"name":"X-Api-Key","in":"header","description":"Harness personal or service access token","allowEmptyValue":true,"schema":{"type":"string","description":"Harness personal or service access token"}}],"responses":{"200":{"description":"OK response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplicationsApplicationOverviewResponseBody"}}}},"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"}}}}}}}}}
```

## List application targets

> List the scanned members of one application.

```json
{"openapi":"3.0.3","info":{"title":"Harness Security Test Orchestration API","version":"1.0.0"},"tags":[{"name":"Applications","description":"User-created groups of already-scanned targets in one project"}],"servers":[{"url":"https://app.harness.io/gateway/sto"},{"url":"http://127.0.0.1:4000"}],"security":[{"X-Api-Key_header_X-Api-Key":[],"jwt_header_Authorization":["sto_testtarget_view"]}],"components":{"securitySchemes":{"X-Api-Key_header_X-Api-Key":{"type":"apiKey","name":"X-Api-Key","in":"header"},"jwt_header_Authorization":{"type":"http","scheme":"bearer"}},"schemas":{"ApplicationsListApplicationTargetsResponseBody":{"type":"object","properties":{"pagination":{"$ref":"#/components/schemas/Pagination"},"results":{"type":"array","items":{"$ref":"#/components/schemas/ApplicationTargetRow"},"description":"One page of members"}},"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"]},"ApplicationTargetRow":{"type":"object","properties":{"defaultRef":{"type":"string","description":"Baseline variant name. Omitted when the target has no baseline."},"id":{"type":"string","description":"Target id","pattern":"^[a-zA-Z0-9_-]{22}$"},"isBaseline":{"type":"boolean","description":"Whether the tracked variant on target_summary is the baseline"},"lastExecution":{"$ref":"#/components/schemas/ApplicationTargetLastExecution"},"lastScanAt":{"type":"integer","description":"Last scan time in milliseconds since Unix epoch. Omitted when the member has no last scan.","format":"int64"},"name":{"type":"string","description":"Target name"},"occurrenceSeverityCounts":{"$ref":"#/components/schemas/ArtifactSeverityCounts"},"scanTypes":{"type":"array","items":{"type":"string"},"description":"Scan types on this member, sorted by name"},"source":{"type":"string","description":"Repository SCM source for repository members, or artifact source for container members. Omitted when unknown or blank.","maxLength":256},"type":{"type":"string","description":"Target type. repository or container. container is an artifact.","enum":["repository","container"]},"url":{"type":"string","description":"Repository or artifact URL from target or latest execution metadata.","maxLength":1024}},"description":"One member on the Targets tab.","required":["id","name","type","isBaseline","scanTypes","occurrenceSeverityCounts"]},"ApplicationTargetLastExecution":{"type":"object","properties":{"buildId":{"type":"string","description":"CI build id/number shown in UI (e.g. 222). Falls back to executionId when build id is unset."},"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},"executionScanTypes":{"type":"array","items":{"type":"string"},"description":"Scan types run in this execution. UI may use these when pipelineName is empty."},"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."},"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},"pipelineName":{"type":"string","description":"Pipeline name shown under the build id","maxLength":256},"targetVariantId":{"type":"string","description":"Variant id for the tracked summary row. Pass as variantId on findings APIs scoped to this execution.","pattern":"^[a-zA-Z0-9_-]{22}$"}},"description":"Latest scan execution for this application member (target_summary last execution).","required":["buildId","executionId","executionScanTypes"]},"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"]},"NotFound":{"type":"object","properties":{"message":{"type":"string"},"status":{"type":"integer","default":404,"format":"int64"}},"required":["message"]}}},"paths":{"/api/v2/applications/{id}/targets":{"get":{"tags":["Applications"],"summary":"List application targets","description":"List the scanned members of one application.","operationId":"Applications#ListApplicationTargets","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":"page","in":"query","description":"Page number to fetch, starting from 0","allowEmptyValue":true,"schema":{"type":"integer","description":"Page number to fetch, starting from 0","default":0,"format":"int64","minimum":0}},{"name":"pageSize","in":"query","description":"Results per page","allowEmptyValue":true,"schema":{"type":"integer","description":"Results per page","default":10,"format":"int64","minimum":1,"maximum":100}},{"name":"search","in":"query","description":"Case-insensitive target name substring","allowEmptyValue":true,"schema":{"type":"string","description":"Case-insensitive target name substring","maxLength":256}},{"name":"type","in":"query","description":"Target type. repository or container. container is an artifact.","allowEmptyValue":true,"schema":{"type":"string","description":"Target type. repository or container. container is an artifact.","enum":["repository","container"]}},{"name":"severity","in":"query","description":"Comma-separated severities. Keeps a member whose own occurrence count for any listed severity is greater than 0.","allowEmptyValue":true,"schema":{"type":"string","description":"Comma-separated severities. Keeps a member whose own occurrence count for any listed severity is greater than 0.","pattern":"^((critical|high|medium|low|info|unassigned)(,(critical|high|medium|low|info|unassigned))*)?$"}},{"name":"isBaseline","in":"query","description":"When set, keeps only members whose tracked target_summary row is baseline (same semantics as repository and artifact lists).","allowEmptyValue":true,"schema":{"type":"boolean","description":"When set, keeps only members whose tracked target_summary row is baseline (same semantics as repository and artifact lists)."}},{"name":"sort","in":"query","description":"Sort field","allowEmptyValue":true,"schema":{"type":"string","description":"Sort field","default":"lastScanAt","enum":["lastScanAt","severity","name"]}},{"name":"order","in":"query","description":"Sort direction. Omitted with sort=name means ASC. Otherwise omitted means DESC.","allowEmptyValue":true,"schema":{"type":"string","description":"Sort direction. Omitted with sort=name means ASC. Otherwise omitted means DESC.","enum":["ASC","DESC"]}},{"name":"id","in":"path","description":"Application id","required":true,"schema":{"type":"string","description":"Application id","pattern":"^[a-zA-Z0-9_-]{22}$"}},{"name":"X-Api-Key","in":"header","description":"Harness personal or service access token","allowEmptyValue":true,"schema":{"type":"string","description":"Harness personal or service access token"}}],"responses":{"200":{"description":"OK response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplicationsListApplicationTargetsResponseBody"}}}},"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"}}}}}}}}}
```

## Get an application's findings trend

> Daily findings bars for one application: occurrence counts by severity and issue type, summed over the member targets' baseline series for each UTC day. Each target contributes its latest execution that ended before the next UTC midnight, carried forward on days with no new execution.

```json
{"openapi":"3.0.3","info":{"title":"Harness Security Test Orchestration API","version":"1.0.0"},"tags":[{"name":"Applications","description":"User-created groups of already-scanned targets in one project"}],"servers":[{"url":"https://app.harness.io/gateway/sto"},{"url":"http://127.0.0.1:4000"}],"security":[{"X-Api-Key_header_X-Api-Key":[],"jwt_header_Authorization":["sto_testtarget_view"]}],"components":{"securitySchemes":{"X-Api-Key_header_X-Api-Key":{"type":"apiKey","name":"X-Api-Key","in":"header"},"jwt_header_Authorization":{"type":"http","scheme":"bearer"}},"schemas":{"ApplicationsApplicationFindingsTrendResponseBody":{"$ref":"#/components/schemas/ApplicationFindingsTrendResult"},"ApplicationFindingsTrendResult":{"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/ApplicationFindingsTrendPoint"},"description":"One point per UTC day"}},"description":"Daily findings bars for an application, oldest to newest","required":["trend","availableIssueTypes"]},"ApplicationFindingsTrendPoint":{"type":"object","properties":{"critical":{"type":"integer","description":"Critical occurrence count","format":"int64"},"day":{"type":"integer","description":"Unix timestamp for the day (midnight UTC)","format":"int64"},"high":{"type":"integer","description":"High occurrence count","format":"int64"},"info":{"type":"integer","description":"Info occurrence count","format":"int64"},"issueTypes":{"type":"object","description":"Occurrence counts grouped by issue type (e.g. SAST, SCA, SECRET)","additionalProperties":{"type":"integer","format":"int64"}},"low":{"type":"integer","description":"Low occurrence count","format":"int64"},"medium":{"type":"integer","description":"Medium occurrence count","format":"int64"}},"description":"Occurrence counts for one UTC day, summed over the application's member targets","required":["day","critical","high","medium","low","info","issueTypes"]},"NotFound":{"type":"object","properties":{"message":{"type":"string"},"status":{"type":"integer","default":404,"format":"int64"}},"required":["message"]}}},"paths":{"/api/v2/applications/{id}/trend/findings":{"get":{"tags":["Applications"],"summary":"Get an application's findings trend","description":"Daily findings bars for one application: occurrence counts by severity and issue type, summed over the member targets' baseline series for each UTC day. Each target contributes its latest execution that ended before the next UTC midnight, carried forward on days with no new execution.","operationId":"Applications#ApplicationFindingsTrend","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":"intervalDays","in":"query","description":"Number of trailing days to return","allowEmptyValue":true,"schema":{"type":"integer","description":"Number of trailing days to return","default":30,"format":"int64","minimum":1,"maximum":90}},{"name":"issueTypes","in":"query","description":"Comma-separated issue types to include. Empty means all.","allowEmptyValue":true,"schema":{"type":"string","description":"Comma-separated issue types to include. Empty means all.","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)*$"}},{"name":"id","in":"path","description":"Application id","required":true,"schema":{"type":"string","description":"Application id","pattern":"^[a-zA-Z0-9_-]{22}$"}},{"name":"X-Api-Key","in":"header","description":"Harness personal or service access token","allowEmptyValue":true,"schema":{"type":"string","description":"Harness personal or service access token"}}],"responses":{"200":{"description":"OK response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplicationsApplicationFindingsTrendResponseBody"}}}},"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"}}}}}}}}}
```

## Get an application's remediation trend

> Daily remediation points for one application: cumulative new and cumulative remediated occurrences, summed over the member targets' baseline series for each UTC day. Each target contributes its latest execution that ended before the next UTC midnight, carried forward on days with no new execution.

```json
{"openapi":"3.0.3","info":{"title":"Harness Security Test Orchestration API","version":"1.0.0"},"tags":[{"name":"Applications","description":"User-created groups of already-scanned targets in one project"}],"servers":[{"url":"https://app.harness.io/gateway/sto"},{"url":"http://127.0.0.1:4000"}],"security":[{"X-Api-Key_header_X-Api-Key":[],"jwt_header_Authorization":["sto_testtarget_view"]}],"components":{"securitySchemes":{"X-Api-Key_header_X-Api-Key":{"type":"apiKey","name":"X-Api-Key","in":"header"},"jwt_header_Authorization":{"type":"http","scheme":"bearer"}},"schemas":{"ApplicationsApplicationRemediationTrendResponseBody":{"$ref":"#/components/schemas/ApplicationRemediationTrendResult"},"ApplicationRemediationTrendResult":{"type":"object","properties":{"trend":{"type":"array","items":{"$ref":"#/components/schemas/ApplicationRemediationTrendPoint"},"description":"One point per UTC day"}},"description":"Daily remediation points for an application, oldest to newest","required":["trend"]},"ApplicationRemediationTrendPoint":{"type":"object","properties":{"cumulativeNew":{"type":"integer","description":"Sum of cumulative discovered occurrences across member targets as of this day","format":"int64"},"cumulativeRemediated":{"type":"integer","description":"Sum of cumulative remediated occurrences across member targets as of this day","format":"int64"},"day":{"type":"integer","description":"Unix timestamp for the day (midnight UTC)","format":"int64"}},"description":"Cumulative new vs remediated occurrence counts for one UTC day, summed over the application's member targets","required":["day","cumulativeNew","cumulativeRemediated"]},"NotFound":{"type":"object","properties":{"message":{"type":"string"},"status":{"type":"integer","default":404,"format":"int64"}},"required":["message"]}}},"paths":{"/api/v2/applications/{id}/trend/remediation":{"get":{"tags":["Applications"],"summary":"Get an application's remediation trend","description":"Daily remediation points for one application: cumulative new and cumulative remediated occurrences, summed over the member targets' baseline series for each UTC day. Each target contributes its latest execution that ended before the next UTC midnight, carried forward on days with no new execution.","operationId":"Applications#ApplicationRemediationTrend","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":"intervalDays","in":"query","description":"Number of trailing days to return","allowEmptyValue":true,"schema":{"type":"integer","description":"Number of trailing days to return","default":30,"format":"int64","minimum":1,"maximum":90}},{"name":"id","in":"path","description":"Application id","required":true,"schema":{"type":"string","description":"Application id","pattern":"^[a-zA-Z0-9_-]{22}$"}},{"name":"X-Api-Key","in":"header","description":"Harness personal or service access token","allowEmptyValue":true,"schema":{"type":"string","description":"Harness personal or service access token"}}],"responses":{"200":{"description":"OK response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplicationsApplicationRemediationTrendResponseBody"}}}},"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"}}}}}}}}}
```

## Get applications overview

> Project cards. A target that belongs to several applications is counted once.

```json
{"openapi":"3.0.3","info":{"title":"Harness Security Test Orchestration API","version":"1.0.0"},"tags":[{"name":"Applications","description":"User-created groups of already-scanned targets in one project"}],"servers":[{"url":"https://app.harness.io/gateway/sto"},{"url":"http://127.0.0.1:4000"}],"security":[{"X-Api-Key_header_X-Api-Key":[],"jwt_header_Authorization":["sto_testtarget_view"]}],"components":{"securitySchemes":{"X-Api-Key_header_X-Api-Key":{"type":"apiKey","name":"X-Api-Key","in":"header"},"jwt_header_Authorization":{"type":"http","scheme":"bearer"}},"schemas":{"ApplicationsApplicationsOverviewResponseBody":{"$ref":"#/components/schemas/ApplicationsOverviewResult"},"ApplicationsOverviewResult":{"type":"object","properties":{"artifactCount":{"type":"integer","description":"Distinct counted artifacts","format":"int64","minimum":0},"occurrenceNewDelta":{"type":"integer","description":"Sum, once per counted target, of its cumulative_open_occurrences_count vs its previous execution of the tracked variant. Same comparison as ApplicationListItem.occurrenceNewDelta. Omitted when no counted target has a previous execution.","format":"int64"},"occurrenceRemediatedDelta":{"type":"integer","description":"Sum, once per counted target, of its cumulative_remediated_occurrences_count vs its previous execution of the tracked variant. Same caveats as occurrenceNewDelta.","format":"int64"},"occurrenceSeverityTotals":{"$ref":"#/components/schemas/ArtifactSeverityCounts"},"repositoryCount":{"type":"integer","description":"Distinct counted repositories","format":"int64","minimum":0},"scanType":{"type":"object","description":"Scan types on counted targets in the project mapped to scanner ids and display names. Keys match scanTypes.","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/ScanTypeScanner"}}},"scanTypes":{"type":"array","items":{"type":"string"},"description":"Distinct scan types that appear on counted targets in the project, sorted by name. A type no target has been scanned with is omitted."},"totalApplications":{"type":"integer","description":"Live applications in the project, including those with no counted members","format":"int64","minimum":0},"totalTargets":{"type":"integer","description":"Distinct counted targets","format":"int64","minimum":0}},"description":"The three project cards. Targets and findings are unique across applications.","required":["totalApplications","totalTargets","repositoryCount","artifactCount","scanTypes","occurrenceSeverityTotals"]},"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/applications/overview":{"get":{"tags":["Applications"],"summary":"Get applications overview","description":"Project cards. A target that belongs to several applications is counted once.","operationId":"Applications#ApplicationsOverview","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":"X-Api-Key","in":"header","description":"Harness personal or service access token","allowEmptyValue":true,"schema":{"type":"string","description":"Harness personal or service access token"}}],"responses":{"200":{"description":"OK response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplicationsApplicationsOverviewResponseBody"}}}},"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"}}}}}}}}}
```
