Permission-to-API Mapping
If you use the Druva inSync REST APIs, each API requires specific permissions. The following tables list the minimum permissions required for each API category.
User Management APIs
API | Endpoint | Method | Minimum Permission Required |
GET | View Users | ||
POST | Create and Import Users | ||
/v1/users/{userID} | GET | View Users | |
/v1/users/{userID} | PATCH | Manage Users | |
/v1/users/{userID} | DELETE | Delete Users | |
/v1/users/{userID}/resetPassword | POST | Manage Users | |
/v1/users/{userID}/preserve | POST | Manage Users | |
/v1/users/{userID}/activate | POST | Manage Users | |
/v1/users/{userID}/download_user_auth_key | GET | Download Auth Keys |
Profile Management APIs
API | Endpoint | Method | Minimum Permission Required |
/v1/profiles | GET | View Profiles | |
/v1/profiles/{profileID} | GET | View Profiles |
Endpoint APIs
Base URL: https://apis.druva.com/insync/endpoints
API | Endpoint | Method | Minimum Permission Required |
GET | View Users | ||
GET | View Users | ||
/v1/devices/{deviceID} | GET | View Users | |
/v2/devices/{deviceID} | GET | View Users | |
/v1/devices/{deviceID} | DELETE | Delete Workload | |
/v1/devices/{deviceID}/disable | POST | Manage Workload | |
/v1/devices/{deviceID}/enable | POST | Manage Workload | |
/v1/devices/{deviceID}/decommission | POST | Decommission Devices | |
/v1/devices/{deviceID}/upgradeClient | POST | Upgrade inSync Device |
Endpoint Mapping APIs
Base URL: https://apis.druva.com/insync/endpoints
API | Endpoint | Method | Minimum Permission Required |
POST | Manage Device Mappings | ||
GET | Manage Device Mappings | ||
/v1/devicemappings/{mappingID} | DELETE | Manage Device Mappings |
Endpoint Backup and Restore APIs
Base URL: https://apis.druva.com/insync/endpoints
API | Endpoint | Method | Minimum Permission Required |
GET | View Users | ||
GET | View Restores | ||
/v1/restores/{restoreID} | GET | View Restores | |
POST | Manage Restores |
Legal Hold APIs
Base URL: https://apis.druva.com/insync/legalholds
API | Endpoint | Method | Minimum Permission Required |
/v3/policies | GET | View legal holds, Create and manage legal holds | |
/v4/policies | GET | View legal holds, Create and manage legal holds | |
/v3/policies/{policyId} | GET | View legal holds, Create and manage legal holds | |
/v4/policies/{policyId} | GET | View legal holds, Create and manage legal holds | |
/v3/policies/{policyId}/users | GET | View legal holds, Create and manage legal holds | |
/v4/policies/{policyId}/users | GET | View legal holds, Create and manage legal holds | |
/v4/policies/{policyId}/collection-stream | GET | View legal hold clients, Create and manage legal holds | |
/v4/clients | GET | View legal hold clients, Create and manage legal holds | |
/v4/clients/{clientId} | GET | View legal hold clients, Create and manage legal holds | |
/v4/job/{jobId} | GET | View legal hold clients, Create and manage legal holds | |
/v4/job | PUT | Manage legal hold clients | |
/v4/jobs | GET | View legal hold clients, Create and manage legal holds | |
/v3/policies | POST | Create and manage legal holds | |
/v4/policies | POST | Create and manage legal holds | |
/v4/policies/{policyId} | DELETE | Delete legal holds | |
/v4/policies/{policyId} | DELETE | Delete legal holds | |
/v3/policies/{policyId}/users | POST | Manage legal hold settings | |
/v3/users/policies | POST | View legal holds | |
/v4/policies/{policyId} | PUT | Manage legal hold settings | |
/v4/job | POST | Manage legal hold clients |
Event Management APIs
API | Endpoint | Method | Minimum Permission Required |
/v2/events | GET | View and download reports and view alerts |
Storage Management APIs
API | Endpoint | Method | Minimum Permission Required |
/v1/storages | GET | View Storages | |
/v1/storages/{storageID} | GET | View Storages | |
/v1/cloudcaches | GET | View Storages | |
/v1/cloudcaches/{cloudCacheID} | GET | View Storages |
AD/LDAP Management APIs
API | Endpoint | Method | Minimum Permission Required |
/v1/adConnectors | GET | View Users |
Audit Trail Management APIs
API | Endpoint | Method | Minimum Permission Required |
/v1/auditTrailSettings | GET | View inSync Settings |
Federated Search APIs
Base URL: https://apis.druva.com/insync/search/mds
API | Endpoint | Method | Minimum Permission Required |
/v1/user/files | GET | Access Federated Search | |
/v1/user/emails | GET | Access Federated Search |
Sensitive Data Governance APIs
Base URL: https://apis.druva.com/insync/sdg
API | Endpoint | Method | Minimum Permission Required |
/v1/datatypes | GET | View Sensitive Data Governance Violations and Settings | |
/v1/policyTemplates | GET | View Sensitive Data Governance Violations and Settings | |
/v1/policies | GET | View Sensitive Data Governance Violations and Settings | |
/v1/whitelistKeywords | GET | View Sensitive Data Governance Violations and Settings | |
/v1/settings | GET | View Sensitive Data Governance Violations and Settings | |
/v1/fileViolations | GET | View Sensitive Data Governance Violations and Settings | |
/v1/emailViolations | GET | View Sensitive Data Governance Violations and Settings |
Authentication API
API | Endpoint | Method | Minimum Permission Required |
GET |
|
Microsoft 365 APIs
API | Endpoint | Method | Minimum Permission Required |
GET | View Users | ||
/v2/siteCollections/{site_collection_id}/restorePoints | GET | View Restores | |
POST | Manage Restores | ||
GET | View Users | ||
GET | View Restores | ||
POST | Manage Restores | ||
GET | View Users |