Get the devices with their AI tools counts
Return every device Primo found AI tools on, by name, as JSON data: the device and its owner, how many tools, running tools, MCP servers, remote AI connections and instruction files it has, its findings per severity and the worst one. Narrow with search (device name, serial number or owner) and worstSeverity (a list). Use it for “which Macs have a critical AI finding”; for the full inventory of one device use getAiToolsDevice, for the findings themselves getAiFindings. 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 items whose worst finding has one of these severities (repeat the param or comma separate)
critical, high, medium, low Part of the device name, its serial number or its owner's name