List Reports
GET/reports
Return a paginated list of reports.
Non-admin callers only see reports whose source runs belong to workspaces
they are a member of. project_id / run_id narrow the page to a single
project or run; an id matching nothing — including one outside the caller's
workspaces — yields an empty page. sort=project groups by Project → Run
for the global reports page, ordering the groups by project name; the default
is newest-first by created_at.
workspace_id narrows the page to one workspace, and does not follow that
empty-page rule: a non-admin naming a workspace outside their accessible set
receives 403, matching the other list endpoints that accept this parameter.
Admins are unrestricted and skip that check, so for them an unknown id is
simply a filter matching nothing. Because a report's workspace resolves
through its run's project, a page filtered by workspace_id excludes
reports whose run has no project.
Request
Responses
- 200
- 403
- 422
Successful Response
Forbidden
Validation Error