Get the AI tools settings of the company
Return the company’s AI tools settings as JSON: defaultPolicy, the policy a tool gets the first time a device reports it; the findings the company ignores, by severity (ignoredSeverities) or by rule (ignoredRules); whether a device assigned to no employee (excludeUnassignedDevices) or in stock (excludeInStockDevices) raises no finding; and rules, every rule Primo rates with its code, title, severity and whether the company ignores it. An ignored finding is left out of every other AI tools read. To change these use updateAiToolsSettings; the policy of one tool is setAiToolPolicy. 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>.
Response
The policy a tool gets the first time a device reports it; the tools already seen keep theirs
not_reviewed, approved, blocked The severities whose findings the company ignores, e.g. ["low"]
critical, high, medium, low The rule codes whose findings the company ignores whatever their severity, e.g. ["unpinned_dependency"]
2001 - 100true: a device assigned to no employee raises no finding (its tools stay listed)
true: a device in stock raises no finding (its tools stay listed)
Every rule Primo rates, worst severity first