get-findings
Retrieve and summarize client findings from OnSecurity, optionally filterable by round ID or type. Presents data clearly for client understanding, with customizable sorting, limits, and optional related data inclusion.
Instructions
Get all findings data from OnSecurity from client in a high level summary, only include the summary, not the raw data and be sure to present the data in a way that is easy to understand for the client. You can optionally filter findings by round_id. HOWEVER ONLY USE THIS TOOL WHEN ASKED FOR FINDINGS RELATED TO A CLIENT OR MY FINDINGS, NOT THE BLOCKS TOOL.
Input Schema
Name | Required | Description | Default |
---|---|---|---|
fields | No | Optional comma-separated list of fields to return (e.g. 'id,name'). Use * as wildcard. | |
filters | No | Optional additional filters in format {field: value} or {field-operator: value} where operator can be mt (more than), mte (more than equal), lt (less than), lte (less than equal), eq (equals, default) | |
includes | No | Optional related data to include as comma-separated values (e.g. 'client,round,target_components') | |
limit | No | Optional limit parameter for max results per page (e.g. 15) | |
page | No | Optional page number to fetch (default: 1) | |
round_id | No | Optional round ID to filter findings | |
round_type | No | Optional round type to filter rounds, 1 = pentest round, 3 = scan round | |
search | No | Search term to find findings by name of finding or related content | |
sort | No | Optional sort parameter in format 'field-direction'. Available values: name-asc, round_id-asc, created_at-asc, updated_at-asc, name-desc, round_id-desc, created_at-desc, updated_at-desc. Default: id-asc |