List findings
The findings Auditor's reviews posted on the team's pull requests, newest first. Findings a review held back, muted or only ran as a dry run were never posted and are not listed.
Query
- repositorystringoptional
Only this repository, as
owner/name. - pull_requestintegeroptional
Only this pull request's findings. Give repository with it: numbers repeat across repositories.
- statusstringoptional
open,resolvedordismissed. Left out: all three. - severitystringoptional
high,mediumorlow. - sincestringoptional
An ISO 8601 time: only findings posted or changed at or after it.
- limitintegeroptional
1 to 100. Default 50.
- cursorstringoptional
The
next_cursorof the page before.
Response
- dataarrayrequired
Each finding: where it is (
repository,pull_request,path,start_line,line), thereviewthat found it, andcomment_url, its review comment on GitHub.lineis null for a finding about the whole file. - sourcestringoptional
deep_review,rule(withrule, its id),static_analysis,store_checkorsettings_file. - resolutionstring | nulloptional
Why it is resolved or dismissed:
code_changed,suggestion_applied,agent_fixed,human_dismissed,thumbs_down,conceded,intentional,wont_fix;thumbs_upon an open finding someone with write access agreed with.decided_byis the GitHub login that decided it, ormcpfor a coding agent; null when a review saw the code change. - next_cursorstring | nullrequired
Pass it as cursor for the next page; null on the last.
One finding
- GET /auditor/findings/:idoptional
The same fields, and
explanation(what the comment says),suggestion(the replacement it proposed, if any),flagged_code,found_at_commitandkeep_open. An id that is not the team's returns404 not_found.