Skip to main content

Checking macOS Permissions via API

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

Marija Djurdjevic avatar
Written by Marija Djurdjevic
Updated today

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

  1. Use the GET Employee - get endpoint → [API Reference Link]

  2. 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

Did this answer your question?