Managing Shares and Permissions via MyWorkDrive Public API

MyWorkDrive version 7.1 introduces a powerful new Public API that allows administrators to automate the creation, configuration, and removal of file shares and permissions using HTTP requests. This API is designed for advanced users who need to integrate share management into external systems, scripts, or orchestration workflows.

Getting Started

1. Enable the API Go to Admin Panel > Enterprise Enable the Public API Copy your API Key

All requests must include the API key in the HTTP header: Header: ApiKey: {your-api-key}

2. Access the API API is hosted locally (by default) on: http://127.0.0.1:8360

Share Management Endpoints

Note: Shares will only appear in the Admin Panel if at least one permission is assigned. API changes may take up to 5 minutes to reflect due to caching.

Permission Management Endpoints

PlacePermission Parameters

Example (for Entra ID Group): GET /api/v3/PlacePermission?name=All%20Entra%20ID%20Members&shareName=LocalTest&domainName=&isGroup=true&webClientAllowed=true&desktopClientAllowed=true&mobileClientAllowed=true&publicSharingEnabled=true&dlpDownloadEnabled=true&dlpOfficeOnlineEditEnabled=true

Storage Providers

To create a share, you need the storageProviderId.

How to Retrieve It: 1. Go to Admin Panel > Integrations 2. Create a new storage entry (e.g., Azure Blob, Azure Files, SMB) 3. Check the General.xml file in Wanpath<span class="SpellE">wanpath.data\settings for the generated storageProviderId

⚠️ Currently, API support for managing storage providers (add/delete) is under consideration.

Notes and Limitations

• Cache Delay: Updates may take up to 5 minutes to appear in the Admin Panel. • Delete Behavior: Deleting a share does NOT automatically delete associated permissions (must be done as a separate post). • HTTP Verbs: The API is verb-agnostic (GET, POST, etc.), but examples here use GET for simplicity. • Spaces & Encoding: URL parameters must be URL-encoded (e.g., All Entra ID Members → All%20Entra%20ID%20Members). • Modifications: To modify a share or permission, delete and re-create it.

Security Considerations

This API is designed to run on a private local network interface by default. Making it publicly accessible should be done with extreme caution. For security, the Management API is hosted on a separate IIS site Wanpath.Admin.API on port 8360.  For additional security add a host name and SSL certificate to this IIS site while continuing to limit access via firewall or authentication controls.