WebDAV
Mount your organisation's documents as a network drive in Finder, File Explorer, or any WebDAV client — generate an app-password under Settings > API > WebDAV and connect from your device.
3 min read
WebDAV turns Tale's document store into a remote folder you mount like any shared network drive. The backing store is the same one the Document Hub shows — what you drop into the mounted folder appears in the UI, and vice versa. Everything you need is on one panel: Settings > API > WebDAV carries the connection details and the app-password generator.
Generate an app-password
The endpoint authenticates with app-passwords — short secrets you mint per device — because every WebDAV client stores its credential in the system keychain, and a scoped, revocable secret belongs there rather than your account password. Your account password does not work on this endpoint.
Click Generate, label the password after the device (MacBook Finder, ops-laptop rclone), and copy it — use one per device; the full password is only shown once. Afterwards the table keeps only the label and a short prefix, enough to recognise the row when you revoke it. Generating requires the same capability that gates API keys; plain members ask an admin.
For the username, use your Tale account email. Only the password is actually verified, but the email keeps audit rows readable and matches what client dialogs expect.
Connect from your device
The address is the URL from the panel — https://<your-site>/dav/<orgSlug>/documents/.
Press ⌘K (Connect to Server), paste the URL, and sign in with your email and the app-password. The share mounts in the sidebar; drag files in to upload, out to download, and rename or delete in place. The first listing of a large tree can take a few seconds.
What the mount can do
Reads and writes mirror your Document Hub permissions, files you upload index and search like direct uploads, and their source field is set to webdav for filtering in audit views. Project files are the exception: a project's Knowledge tab is scoped to that one project and never appears over WebDAV, so the mount shows only the org-wide Document Hub. The .trash/ namespace lists soft-deleted documents read-only — download for recovery, restore through the UI. Editors that take WebDAV locks (Office, LibreOffice) get them; a competing write during an edit returns 423 Locked.
Revoking
Revoke a password with the trash icon on its row — the next request with it is rejected, other devices are untouched, and any locks it held are released. There is no undo; mint a new password if you revoke the wrong row.
Where this fits
WebDAV is the per-user, device-facing door to the same data as the Document Hub; the wire protocol lives under WebDAV API. For machine-to-machine imports, API keys plus the REST API are usually the better fit.