Full name: projects.locations.instances.findingsRefinements.list
Lists a collection of findings refinements.
HTTP request
Path parameters
Parameters
parent
string
Required. The parent, which owns this collection of findings refinements. Format: projects/{project}/locations/{location}/instances/{instance}
Query parameters
Parameters
pageSize
integer
The maximum number of findings refinements to return. The service may return fewer than this value. If unspecified, at most 100 rules will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
pageToken
string
A page token, received from a previous findingsRefinements.list call. Provide this to retrieve the subsequent page.
Request body
The request body must be empty.
Response body
Response message for findingsRefinements.list method.
If successful, the response body contains data with the following structure:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-25 UTC."],[[["\u003cp\u003eThis API endpoint \u003ccode\u003eprojects.locations.instances.findingsRefinements.list\u003c/code\u003e is used to retrieve a list of findings refinements.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eGET\u003c/code\u003e request to \u003ccode\u003ehttps://chronicle.googleapis.com/v1alpha/{parent}/findingsRefinements\u003c/code\u003e requires a \u003ccode\u003eparent\u003c/code\u003e path parameter, specifying the resource path.\u003c/p\u003e\n"],["\u003cp\u003eOptional query parameters include \u003ccode\u003epageSize\u003c/code\u003e (for the number of refinements returned) and \u003ccode\u003epageToken\u003c/code\u003e (for pagination).\u003c/p\u003e\n"],["\u003cp\u003eThe response body returns a JSON object that contains a list of \u003ccode\u003efindings_refinements\u003c/code\u003e and a \u003ccode\u003enext_page_token\u003c/code\u003e for retrieving subsequent pages.\u003c/p\u003e\n"],["\u003cp\u003eAccessing this endpoint requires the OAuth scope \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e and the IAM permission \u003ccode\u003echronicle.findingsRefinements.list\u003c/code\u003e on the parent resource.\u003c/p\u003e\n"]]],[],null,[]]