Skip to main content
MacOS Permissions Visibility via API

Insightful provides detailed visibility into granted MacOS permissions via API at both user and organization levels.

K
Written by Katarina Dakic
Updated this week

To ensure all Insightful features operate as they should on macOS, specific set up of system permissions is required. For example - if a device is not capturing screenshots, it likely means the Screen and Audio Recording macOS permission is not granted.

To learn more about the required set up of system permission needed for Insightful to operate seamlessly on macOS devices, please review this article.

Levels of macOS Permissions Visibility

Insightful provides detailed visibility into granted permissions at two levels:

  • Per Employee: Displays devices linked to individual employees and their permissions.

  • Per Organization: Shows all employees, their devices, and the status of required permissions.

Permissions overview via API

Use specific endpoints on API to check permissions by employee or organization.

  • If you wish to check permissions per employee you should call this function:

    GET Employee - get, with more details on this link.

    • For individual employees, the system returns a list of devices with permission statuses:

      • authorized

      • denied or undetermined

  • If you wish to check permissions for all employees under their organization you should use this function: GET Employee - list, with more details on this link

    • For organizational data, the API provides a consolidated view of permissions across all employees.

To learn more about remotely configuring macOS permissions for deploying the Insightful application and ensuring seamless operation by setting up Accessibility, Automation, and Screen & System Audio Recording permissions using configuration profiles, please visit article: How to handle macOS permissions remotely via configuration profiles.

Did this answer your question?