Druva Endpoints and Data Governance GovCloud API

{"openapi":"3.0.0","info":{"version":"3.0","title":"inSync GovCloud"},"tags":[{"name":"User Management","description":"Lists the APIs to get information and perform operations on users managed in Druva inSync."},{"name":"Profile Management","description":"Lists the APIs to get information about the profiles configured in Druva inSync."},{"name":"Endpoints","description":"Lists the APIs to get information about devices managed in Druva inSync."},{"name":"Legal Hold","description":"Lists the APIs to get information about the legal hold policies, manage users on legal hold and new APIs for eDiscovery Download Client."},{"name":"Event Management","description":"Lists the APIs to get information about the events generated in Druva inSync."},{"name":"Storage Management","description":"Lists the APIs to get information about the storages and inSync CloudCache Servers configured in Druva inSync."},{"name":"AD/LDAP Management","description":"Lists the APIs to get information about the AD/LDAP Connectors configured for Endpoints & SaaS Apps."},{"name":"Audit Trail Management","description":"Lists the APIs to get information about the Audit Trails generated in the Druva Console."}],"paths":{"/usermanagement/v1/users":{"get":{"tags":["User Management"],"summary":"List all users","description":"Returns the list of users in Druva inSync with their details.","security":[{"Bearer":[]}],"parameters":[{"name":"profileID","in":"query","description":"Specify the profile ID to filter and get the list of users associated with a profile. Get the ID of a profile using the 'List all profiles' API.","required":false,"schema":{"type":"integer"}},{"name":"storageID","in":"query","description":"Specify the storage ID to filter and get the list of users associated with a particular storage. Get the ID of a storage using the 'List all storages' API.","required":false,"schema":{"type":"integer"}},{"name":"cacheID","in":"query","description":"Specify the CloudCache Server ID to get the list of users associated with a CloudCache Server. Get the ID of a CloudCache Server using the 'List all CloudCache Servers' API.","required":false,"schema":{"type":"integer"}},{"name":"userIDs","in":"query","description":"Specify unique user IDs, separated by commas, to get details of specific users.","required":false,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"integer"}}},{"name":"emailID","in":"query","description":"Specify the email address to list a user's details.","required":false,"schema":{"type":"string"}},{"name":"searchPrefixEmailID","in":"query","description":"Specify the email prefix by which you intend to search and list the users. Example - In the email address 'ernie.carter@druva.com', 'ernie.carter' is the email prefix.","required":false,"schema":{"type":"string"}},{"name":"searchPrefixUserName","in":"query","description":"Specify the prefix from the user name by which you intend to search and list the users. Example, 'Ern' can be a prefix in the user name 'Ernie'.","required":false,"schema":{"type":"string"}},{"name":"pageToken","in":"query","description":"The token to access the next page of results. Use the token value received in the previous response's parameter 'nextPageToken'.","required":false,"schema":{"type":"string"}},{"name":"minAddedOn","in":"query","description":"Specify the date and time to list users that are added to Druva inSync after it. The time should be specified in the UTC time zone. The format for this parameter value is YYYY-MM-DDTHH:MM:SSZ","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"maxAddedOn","in":"query","description":"Specify the date and time to list users that are added to Druva inSync before it. he time should be specified in the UTC time zone. The format for this parameter value is YYYY-MM-DDTHH:MM:SSZ","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"status","in":"query","description":"Specify the current status of user account to filter and list the users.","required":false,"schema":{"type":"string","enum":["active","preserved"]}},{"name":"ldapGUID","in":"query","description":"Specify the AD or LDAP object GUID to get the list of users associated with it. Pass the parameter as a hex string. Example: B1C47201C67910458867BA19982E353E","required":false,"schema":{"type":"string"}},{"name":"privacySettingsEnabled","in":"query","required":false,"description":"List users based on the status of their privacy settings. For example, if you select True, all the users with their privacy setting enabled are listed.","schema":{"type":"boolean","enum":["true","false"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserList"}}}},"400":{"description":"Bad Request"},"401":{"description":"The request did not include an authentication token or an expired authentication token was supplied."},"404":{"description":"The requested resource was not found."},"500":{"description":"The request was not processed due to an internal error in inSync GovCloud.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"Requested HTTP method is not implemented.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"tags":["User Management"],"summary":"Create a new user","description":"Creates a new user in Druva inSync with the settings defined in this API.","security":[{"Bearer":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","description":"To create a user in Druva inSync.","required":["userName","profileID","storageID","emailID"],"properties":{"userName":{"description":"Specify the username for the user in Druva inSync. Example - Ernie Carter","type":"string","example":"Ernie Carter"},"profileID":{"description":"Specify the ID of the profile to be associated with the user account. Get the ID of a profile using the 'List all profiles' API.","type":"integer","example":2},"storageID":{"description":"Specify the ID of the storage on which the user data backed up by inSync should be stored. Get the ID of a storage using the 'List all storages' API.","type":"integer","example":2},"emailID":{"description":"Specify the email address of the user.","type":"string","example":"ernie.carter@druva.com"},"quota":{"description":"Specify the storage quota that should be allocated to the new user. \n Specify a value between 0 to 1023. Example - 1000  \n :fa-info-circle: If kept blank, the storage quota configured in the profile is assigned to the user.","type":"integer","example":"10"},"quotaUnit":{"description":"Specify the storage unit for the quota value (MB,GB, OR TB).","type":"string","enum":["MB","GB","TB"]},"sendPasswordByEmail":{"description":"Specify whether to send the password to the user by email. If false, password is not sent to the user. Default is true and password will be sent to the user's email address.","type":"boolean","example":true}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserCreate"}}}},"400":{"description":"Bad Request. Provide an appropriate value in the range of 0 to 1023 for User quota."},"401":{"description":"The request did not include an authentication token or an expired authentication token was supplied."},"404":{"description":"The requested resource was not found."},"422":{"description":"The request was well-formed but was not processed due to semantic errors."},"500":{"description":"The request was not processed due to an internal error in inSync GovCloud.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"Requested HTTP method is not implemented.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/usermanagement/v1/users/{userID}":{"get":{"tags":["User Management"],"summary":"Get user information using userID","description":"Returns information about a particular user in Druva inSync using the userID.","security":[{"Bearer":[]}],"parameters":[{"name":"userID","in":"path","description":"The unique ID of a user in inSync. Get the ID of a user using the 'List all users' API.","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/User"}}}},"400":{"description":"Bad Request"},"401":{"description":"The request did not include an authentication token or an expired authentication token was supplied."},"404":{"description":"The requested resource was not found."},"500":{"description":"The request was not processed due to an internal error in inSync GovCloud.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"Requested HTTP method is not implemented.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"tags":["User Management"],"summary":"Update user information using userID","description":"Use this API to update username and profile of an existing user.","security":[{"Bearer":[]}],"parameters":[{"in":"path","name":"userID","description":"Specify the inSync user ID of the user for whom you want to update the username or profile. Get the ID of a user using the ‘List all users’ API.","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","description":"Specify the new value only for those parameters that you want to update for a user in Druva inSync.","properties":{"userName":{"description":"Specify the new username for the user.","type":"string","example":"Ernie Carter"},"profileID":{"description":"Specify the ID of the new profile that you want to associate with the user account. The new profile settings are applied to the user account in the next backup cycle.Get the profile ID using the 'List all profiles' API.\n :fa-info-circle: If you are changing user's profile to a profile where the Privacy Settings conflicts with the Privacy Settings in the old profile, which may result in administrators getting an unintentional access to the user's data, inSync does not allow you to update the profile. In such a case, you must request the inSync user to allow the inSync administrators to access their backed up data (setting on inSync Client) and try again.","type":"integer","example":2}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserCreate"}}}},"400":{"description":"Bad Request"},"401":{"description":"The request did not include an authentication token or an expired authentication token was supplied."},"404":{"description":"The requested resource was not found."},"422":{"description":"The request was well-formed but was not processed due to semantic errors."},"500":{"description":"The request was not processed due to an internal error in inSync GovCloud.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"Requested HTTP method is not implemented.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["User Management"],"summary":"Delete a user","description":"Deletes a user in the system. When you delete a user:\n 1. All the user data (restore points) is deleted.\n 2. If the user that is being deleted has shared data with guest users, this data is also deleted.\n 3. All devices of the user will get deleted, and all the active and preserved licenses that the user was consuming will be freed up.\n 4. You can roll back the deleted user from Rollback Actions until the rollback window lapses.\n 5. After the rollback window lapses, the user will be deleted permanently. For more information, see <a href=https://docs.druva.com/Cyber_Resilience/Rollback_Actions>Rollback Actions</a>.","security":[{"Bearer":[]}],"parameters":[{"name":"userID","in":"path","description":"The unique ID of a user in inSync. Get the ID of a user using the 'List all users' API.","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"deletionReason":{"description":"Specify the reason for user deletion (the character limit of reason is between 10-150) .  This capability will help prevent accidental deletions. If no reason is specified, the default reason i.e. <b>API initiated User Deletion</b> will be displayed.","type":"string","example":"User left the organization."}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad Request"},"401":{"description":"The request did not include an authentication token or an expired authentication token was supplied."},"404":{"description":"The requested resource was not found."},"422":{"description":"The request was well-formed but was unprocessable due to  semantic errors."},"500":{"description":"The request was not processed due to an internal error in inSync GovCloud.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"Requested HTTP method is not implemented.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/usermanagement/v1/users/{userID}/resetPassword":{"post":{"tags":["User Management"],"summary":"Reset password for a user","description":"Resets the password for the user identified using the userID. inSync sends an email with a password reset link to the user.","security":[{"Bearer":[]}],"parameters":[{"name":"userID","in":"path","description":"The unique ID of a user in inSync. Get the ID of a user using the 'List all users' API.","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad Request"},"401":{"description":"The request did not include an authentication token or an expired authentication token was supplied."},"404":{"description":"The requested resource was not found."},"422":{"description":"The request was well-formed but was not processed due to semantic errors."},"500":{"description":"The request was not processed due to an internal error in inSync GovCloud.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"Requested HTTP method is not implemented.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/usermanagement/v1/users/{userID}/preserve":{"post":{"tags":["User Management"],"summary":"Preserve a user","description":"Preserves a user in Druva inSync.\nWhen you preserve a user:\n    1) Backups from the user's device are stopped and the user status changes to Preserved.\n    2) inSync retains the user's data backups as long as the user is Preserved.\n    3) If not activated again, the preserved user is later deleted from inSync after the duration specified in the  Auto-Delete Preserved User settings of the user's profile. ","security":[{"Bearer":[]}],"parameters":[{"name":"userID","in":"path","description":"The unique ID of a user in inSync. Get the ID of a user using the 'List all users' API.","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad Request"},"401":{"description":"The request did not include an authentication token or an expired authentication token was supplied."},"404":{"description":"The requested resource was not found."},"422":{"description":"The request was well-formed but was not processed due to semantic errors."},"500":{"description":"The request was not processed due to an internal error in inSync GovCloud.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"Requested HTTP method is not implemented.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/usermanagement/v1/users/{userID}/activate":{"post":{"tags":["User Management"],"summary":"Activate a user","description":"Activates an already preserved user.\n When you activate a user:\n    1) The user status would change from Preserved to Active.\n    2) State of all devices assigned to this user would change from Disabled to Enabled.\n    3) Backups from the user's device(s) would resume as per the configuration.\n    4) Before activating a user, if a user has consumed, for example, one Endpoints preserved license, then post-activation one Endpoints preserved license is freed up and one Endpoints active license is consumed (the same rationale applies to all workloads).\n    5) The license state of all the workloads associated with this user would change from Preserved to Active only if the user has Active licenses available for all the associated workloads.\n For example, consider this scenario wherein you are trying to activate a user who has consumed one Endpoints preserved license, one Microsoft 365 preserved license, and one Google Workspace preserved license, but the user has only one Microsoft 365 Active license and one Google Workspace Active license available, and Endpoints Active license is not available, then:\n\ta. the user activation would fail, as there is no active Endpoints license available.\n\tb. the user will remain in a preserved state, and the license state of Microsoft 365, Google Workspace, and Endpoints would continue to remain in the preserved state.","security":[{"Bearer":[]}],"parameters":[{"name":"userID","in":"path","description":"The unique ID of a user in inSync. Get the ID of a user using the 'List all users' API.","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad Request"},"401":{"description":"The request did not include an authentication token or an expired authentication token was supplied."},"404":{"description":"The requested resource was not found."},"422":{"description":"The request was well-formed but was not processed due to semantic errors."},"500":{"description":"The request was not processed due to an internal error in inSync GovCloud.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"Requested HTTP method is not implemented.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/usermanagement/v1/users/{userID}/download_user_auth_key":{"get":{"tags":["User Management"],"summary":"Download AuthKey","description":"Downloads the authentication key for users to replace or add a new device","security":[{"Bearer":[]}],"parameters":[{"name":"userID","in":"path","description":"The unique ID of a user in inSync. Get the ID of a user using the 'List all users' API.\n :fa-info-circle: Download the output in an IDK file.","required":true,"schema":{"type":"integer"}},{"name":"deviceID","in":"query","description":"Specify the device ID to download the Authkey for replacing the existing device. Get the ID of a device using the 'List all devices' API.\n Do not specify the device ID to download the Authkey for adding a new device.","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad Request"},"401":{"description":"The request did not include an authentication token or an expired authentication token was supplied."},"404":{"description":"The requested resource was not found."},"500":{"description":"The request was not processed due to an internal error in inSync Gov Cloud.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"Requested HTTP method is not implemented.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/profilemanagement/v1/profiles":{"get":{"tags":["Profile Management"],"summary":"List all profiles","description":"Returns a list of all the profiles configured in Druva inSync.","security":[{"Bearer":[]}],"parameters":[{"name":"pageToken","in":"query","description":"The token to access the next page of results. Use the token value received in the previous response's parameter 'nextPageToken'.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileList"}}}},"400":{"description":"Bad Request"},"401":{"description":"The request did not include an authentication token or an expired authentication token was supplied."},"404":{"description":"The requested resource was not found."},"500":{"description":"The request was not processed due to an internal error in inSync GovCloud.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"Requested HTTP method is not implemented.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/profilemanagement/v1/profiles/{profileID}":{"get":{"tags":["Profile Management"],"summary":"Get profile information","description":"Returns the profile configuration details using the profileID.","security":[{"Bearer":[]}],"parameters":[{"name":"profileID","in":"path","description":"The unique ID of a profile in inSync. Get the ID of a profile using the ‘List all profiles’ API.","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Profile"}}}},"400":{"description":"Bad Request"},"401":{"description":"The request did not include an authentication token or an expired authentication token was supplied."},"404":{"description":"The requested resource was not found."},"500":{"description":"The request was not processed due to an internal error in inSync GovCloud.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"Requested HTTP method is not implemented.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/endpoints/v1/devices":{"get":{"tags":["Endpoints"],"summary":"List all devices - v1","description":"Returns information about all the user devices protected using Druva inSync.","security":[{"Bearer":[]}],"parameters":[{"name":"userID","in":"query","description":"Specify the user ID to get a list of devices associated with a single user. Get the ID of a user using the 'List all users' API.","required":false,"schema":{"type":"integer"}},{"name":"userIDs","in":"query","description":"Specify the user IDs, separated by commas, to get a list of devices associated with multiple users. Get the user IDs using the 'List all users' API.","required":false,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"integer"}}},{"name":"deviceIDs","in":"query","description":"Filter the list of devices by specifying only the required device IDs, separated by commas. Get the device IDs by using this ‘List all devices’ API.","required":false,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"integer"}}},{"name":"profileIDs","in":"query","description":"Specify the profile IDs, separated by commas, to get a list of devices associated with multiple profiles. Get the ID of a profile using the ‘List all profiles’ API.","required":false,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"integer"}}},{"name":"searchPrefixDeviceName","in":"query","description":"Specify the prefix from the device name by which you intend to search and list the devices. Example - “My” is the prefix in the device name “MyDevice123”.","required":false,"schema":{"type":"string"}},{"name":"clientVersion","in":"query","description":"Filter the list of devices by the inSync Client version installed on it. Example - 6.2.0","required":false,"schema":{"type":"string"}},{"name":"platformOS","in":"query","required":false,"description":"Filter the list of devices by specifying the operating system of the device.","schema":{"type":"string","enum":["win32","linux2","darwin","android","ios"]}},{"name":"deviceStatus","in":"query","required":false,"description":"Filter the list by specifying the status of the device.","schema":{"type":"string","enum":["enabled","disabled"]}},{"name":"upgradeState","in":"query","required":false,"description":"The upgrade state of the device.","schema":{"type":"string","enum":["NOT UPGRADABLE","UPGRADABLE","UPTODATE","SCHEDULED","UNKNOWN"]}},{"name":"pageToken","in":"query","description":"The token to access the next page of results. Use the token value received in the previous response's parameter 'nextPageToken'.","required":false,"schema":{"type":"string"}},{"name":"minLastConnected","in":"query","description":"Filter to list devices that are connected to Druva inSync after a particular date. Example format - YYYY-MM-DDTHH:MM:SSZ","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"maxLastConnected","in":"query","description":"Filter to list devices that are connected to Druva inSync before a particular date. Example format - YYYY-MM-DDTHH:MM:SSZ","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"minAddedOn","in":"query","description":"Filter to list devices that are added to Druva inSync after a particular date. Example format - YYYY-MM-DDTHH:MM:SSZ","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"maxAddedOn","in":"query","description":"Filter to list devices that are added to Druva inSync after a particular date. Example format - YYYY-MM-DDTHH:MM:SSZ","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"serialNumber","in":"query","description":"Get device information using the unique serial number assigned to an individual piece of hardware by the manufacturer.","required":false,"schema":{"type":"string"}},{"name":"uuid","in":"query","description":"Get device information using the unique 128-bit number UUID used to identify device on internet.","required":false,"schema":{"type":"string"}},{"name":"deviceMarkedInactive","in":"query","description":"Filter the list of devices that are marked as inactive. For example, if you select true, all devices that are marked as inactive are listed. For more information about inactive devices, see <a href=https://docs.druva.com/Endpoints/030_Set_up_inSync_for_Endpoints/010_Initial_Configuration/030_Create_and_manage_profiles/010_Create_a_profile>Create Profile</a>.","required":false,"schema":{"type":"boolean","enum":["true","false"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeviceList"}}}},"400":{"description":"Bad Request"},"401":{"description":"The request did not include an authentication token or an expired authentication token was supplied."},"404":{"description":"The requested resource was not found."},"500":{"description":"The request was not processed due to an internal error in inSync GovCloud.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"Requested HTTP method is not implemented.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/endpoints/v1/devices/{deviceID}":{"get":{"tags":["Endpoints"],"summary":"Get device information - v1","description":"Returns device information using deviceID.","security":[{"Bearer":[]}],"parameters":[{"name":"deviceID","in":"path","description":"The unique ID of device in inSync. Get the ID of a device using the ‘List all devices’ API.","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Device"}}}},"400":{"description":"Bad Request"},"401":{"description":"The request did not include an authentication token or an expired authentication token was supplied."},"404":{"description":"The requested resource was not found."},"500":{"description":"The request was not processed due to an internal error in inSync GovCloud.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"Requested HTTP method is not implemented.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Endpoints"],"summary":"Delete a device","description":"Deletes a device in the system. When you delete a device:\n 1) All the device data (restore points) is deleted.\n 2) You can roll back the deleted device from Rollback Actions until the rollback window lapses.\n 3) After the rollback window lapses, the device will be deleted permanently. For more information, see <a href=https://docs.druva.com/Cyber_Resilience/Rollback_Actions>Rollback Actions</a>.","security":[{"Bearer":[]}],"parameters":[{"name":"deviceID","in":"path","description":"The unique ID of device in inSync. Get the ID of a device using the ‘List all devices’ API.","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"deletionReason":{"description":"Specify the reason for device deletion, (the character limit of reason is between 10-150) . This capability will help prevent accidental deletions. If no reason is specified, the default reason i.e. <b>API initiated Device Deletion</b> will be displayed.","type":"string","example":"Inactive device"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad Request"},"401":{"description":"The request did not include an authentication token or an expired authentication token was supplied."},"404":{"description":"The requested resource was not found."},"422":{"description":"The request was well-formed but was unprocessable due to  semantic errors."},"500":{"description":"The request was not processed due to an internal error in inSync GovCloud.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"Requested HTTP method is not implemented.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/endpoints/v1/devices/{deviceID}/disable":{"post":{"tags":["Endpoints"],"summary":"Disable a device","description":"Disables a user device. Once disabled, the data backup from the device stops, and the user can no longer restore data to that same device. The data of disabled device is available in inSync and can be restored to different devices belonging to the same user, either by the user or an administrator.","security":[{"Bearer":[]}],"parameters":[{"name":"deviceID","in":"path","description":"The unique ID of device in inSync. Get the ID of a device using the ‘List all devices’ API.","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad Request"},"401":{"description":"The request did not include an authentication token or an expired authentication token was supplied."},"404":{"description":"The requested resource was not found."},"422":{"description":"The request was well-formed but was not processed due to semantic errors."},"500":{"description":"The request was not processed due to an internal error in inSync GovCloud.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"Requested HTTP method is not implemented.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/endpoints/v1/devices/{deviceID}/enable":{"post":{"tags":["Endpoints"],"summary":"Enable a device","description":"Enables a user's device. After the device is enabled, the user of the selected device can start taking its backup and restore.","security":[{"Bearer":[]}],"parameters":[{"name":"deviceID","in":"path","description":"The unique ID of device in inSync. Get the ID of a device using the ‘List all devices’ API.","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad Request"},"401":{"description":"The request did not include an authentication token or an expired authentication token was supplied."},"404":{"description":"The requested resource was not found."},"422":{"description":"The request was well-formed but was not processed due to semantic errors."},"500":{"description":"The request was not processed due to an internal error in inSync GovCloud.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"501":{"description":"Requested HTTP method is not implemented.","content":{"application/json":{"schema":{"$ref":"#/co

# --- truncated at 32 KB (149 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/druva/refs/heads/main/openapi/druva-insync-govcloud-openapi.json