To ensure all Insightful features operate as they should on macOS, a specific setup 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.
If you’re not sure which permissions are required, see: MacOS Permissions Required for Insightful
Levels of macOS Permissions Visibility
Insightful lets you check macOS permission status through the API at two levels:
Per Employee – View devices linked to a specific employee and see their permissions.
Per Organization – Get a full overview of all employees, their devices, and the status of required permissions.
How to Check Permissions via API
You can use dedicated API endpoints to confirm whether permissions have been granted.
1. Check permissions for an individual employee
Use the GET Employee - get endpoint → [API Reference Link]
The system will return a list of that employee’s devices with permission statuses:
authorized
denied
undetermined
2. Check permissions across the entire organization
Use the GET Employee - list endpoint → Insightful API Documentation
This provides a consolidated view of all employees and their devices, showing which permissions are granted or missing.
Getting Started with the API
To access the API, please read Get API collections.
Still stuck? Our team is here to help → support@insightful.io