Sign in

v1

latestOpenAPI 3.1.02026-07-26363186558.0 KB
threatintelligence

SearchFindings is a more powerful version of ListFindings that supports complex queries like "findings for issues" using functions such as has_issue and has_asset in the query string. Example to search for findings for a specific issue: has_issue("name=\"vaults/vault-12345/issues/issue-12345\""))

get/v1beta/projects/{project}/findings:search

Path parameters

projectstring required

Resource ID segment making up resource name. It identifies the resource within its parent collection as described in https://google.aip.dev/122.

Query parameters

querystring

Optional. Query on what findings will be returned. This supports the same filter criteria as FindingService.ListFindings as well as the following relationship queries has_issue and has_asset. Examples:

  • has_issue("name="vaults/vault-12345/issues/issue-12345"")
  • has_asset("name="vaults/vault-12345/assets/asset-12345"")
orderBystring

Optional. Order by criteria in the csv format: "field1,field2 desc" or "field1,field2" or "field1 asc, field2".

pageTokenstring

Optional. Page token.

pageSizeinteger

Optional. Page size.

Headers

x-goog-user-projectstring required

Your organization's project ID

Response

Successful operation

nextPageTokenstring

Page token.