Get the AI risk findings
Return the AI risk findings, worst severity first, one page as JSON (data, pagination): each with its findingKey, rule code, severity and severityLabel, a title and description in words, the device and its owner, and what it is on (subjectName, toolKey). Filter with severity (a list, e.g. critical and high), rule, kind (a tool kind or instruction_file), deviceId and toolKey. These are the risks of AI tools only: MDM compliance alerts are getComplianceAlerts, CVEs getVulnerabilities. AI tools are what Primo finds on Macs (assistant apps, coding agents, IDE plugins, browser extensions, MCP servers, AI connections, agent instruction files), as of the last report (lastSyncedAt of getAiToolsOverview, every 5 minutes), with Primo’s severities, less the findings the company’s AI tools settings ignore. They are not the software catalog (getSoftwares, getDeviceSoftware), the company’s own AI agents (listAgents) nor AI credits (getAiUsage). A company without AI tools monitoring gets a 403, final.
Authorizations
Use your Primo API key in the Authorization header as Bearer <API_KEY>.
Query Parameters
Keep the findings of one tool
Keep the findings of one device
Kind of the tool the finding is on, or instruction_file
assistant_app, coding_agent, ide_plugin, browser_extension, mcp_server, instruction_file A rule's code, e.g. plaintext_secret
Keep the findings of these severities (repeat the param or comma separate)
critical, high, medium, low Page number
Number of items per page (max 100)