Mount as a network drive.

Access your dosya.dev files via WebDAV. Mount in Finder, File Explorer, or any WebDAV client. No app to install.

Get API Key

Settings > API Keys

Connect

api.dosya.dev/webdav/mount/{workspace_id}/{name}/

Browse

Open, edit, save files

Read the guide What is WebDAV and when is it the right choice? A 1999 protocol that still mounts cloud storage as a folder on almost anything. What WebDAV does well, and when S3 or SFTP is the better fit. 4 min read.

Connect with your API key

Sign in with your account email as the username and an API key as the password. Get your API key and workspace ID from dashboard settings.

Server URL

https://api.dosya.dev/webdav/mount/{workspace_id}/{name}/

Username

your account email

Password

dos_your_api_key

Protocol

WebDAV (HTTPS)

Why the URL has your workspace twice

Finder, Explorer and most clients name the mounted drive after the last part of the URL. The workspace ID identifies the mount; the name after it is what you see on your desktop.

https://api.dosya.dev/webdav/mount/ws_k3n8fq2p4x/Design Team/

The ID decides which workspace you reach. The name is only a label. Two of these means you can mount two workspaces that share a name - your own Design Team and a client's - side by side, and both still read as Design Team on your desktop.

Because the label is only a label, renaming a workspace will not break a drive you have already mounted, and you can put your own wording there if you prefer a different caption.

The shorter /webdav/{workspace_id}/ form still works and always will. It also accepts a workspace name or slug in place of the ID - though a name shared by two of your workspaces is refused, since it does not say which one you meant.

What's at the root

The workspace root is not your folder tree. It holds six collections: one real, five read-only.

All

Your real folder tree, and the only writable collection. Uploads, new folders, renames and deletes all go under All/. Mount this path and the drive behaves like an ordinary read-write disk.

Documents, Videos, Images, Shared, Deleted

Flat, read-only views of the whole workspace, filtered by type or state. Browse and download freely; any write returns 403. Some clients report that as a generic error rather than a permission problem, so a copy into one of these can look like it silently did nothing.

Folder-anchored keys

A key pinned to a folder has no view namespace at all. Its mount root is that folder, writable directly, and a folder of yours genuinely named Documents is an ordinary folder rather than a reserved name.

Connect from Finder

Mount your workspace as a network drive directly in macOS Finder.

macOS Finder

# Open Finder
1. Press Cmd + K (or Go > Connect to Server)
2. Enter: https://api.dosya.dev/webdav/mount/your_workspace_id/Your%20Workspace/All/
3. Click Connect
4. Username: your account email
5. Password: dos_your_api_key

# Your workspace appears as a network drive in Finder

Read the guide How to mount cloud storage as a drive on macOS Finder mounts remote storage over WebDAV with no extra software. Here is the setup, the reconnect step, and the one default worth changing first. 5 min read.

Map as network drive

Map your workspace as a network drive in Windows File Explorer.

Windows File Explorer

# Map Network Drive in File Explorer
1. Open File Explorer
2. Right-click This PC > Map network drive
3. Folder: https://api.dosya.dev/webdav/mount/your_workspace_id/Your%20Workspace/All/
4. Check "Connect using different credentials"
5. Username: your account email
6. Password: dos_your_api_key

Mount on Linux

Connect via GNOME Files, KDE Dolphin, or mount from the command line with davfs2.

Linux

# GNOME Files (Nautilus)
1. Press Ctrl + L (or Other Locations > Connect to Server)
2. Enter: davs://api.dosya.dev/webdav/mount/your_workspace_id/Your%20Workspace/All/
3. Username: your account email
4. Password: dos_your_api_key

# Or mount via command line with davfs2
$ sudo apt install davfs2
$ sudo mount -t davfs https://api.dosya.dev/webdav/mount/your_workspace_id/Your%20Workspace/All/ /mnt/dosya

Third-party WebDAV clients

Use any WebDAV client to connect. Here are the connection details for popular apps.

Cyberduck / Mountain Duck / WinSCP

# Cyberduck / Mountain Duck / WinSCP
1. Protocol: WebDAV (HTTPS)
2. Server:   api.dosya.dev
3. Port:     443
4. Path:     /webdav/mount/your_workspace_id/Your%20Workspace/All/
5. Username: your account email
6. Password: dos_your_api_key

Cyberduck

Mountain Duck

WinSCP

Transmit

ForkLift

Commander One

GNOME Files

KDE Dolphin

Read the guide S3 or WebDAV: which should you mount? Both protocols mount remote storage as a drive, but they fail in different places. A practical guide to picking the right one for your workflow. 6 min read.

Supported operations

Everything a WebDAV client needs - browse, transfer, and organize your files from Finder, File Explorer, or any WebDAV app.

PROPFIND

List folders and file details, one level at a time (Depth 0 or 1).

GET / HEAD

Download files. Supports resumable downloads (byte ranges) and ETag caching.

PUT

Upload files. Overwriting a file keeps the previous copy as a version.

MKCOL

Create new folders.

DELETE

Delete files and folders. Deleted files go to the trash.

MOVE

Move or rename files and folders without re-uploading.

COPY

Duplicate a file on the server without downloading it. Files only.

OPTIONS

Lets clients discover what the server supports.

LOCK / UNLOCK

Supported so Windows and Microsoft Office can save files. Files locked in the dashboard stay protected.

Use with curl

Test and automate WebDAV operations directly from the command line.

List files

# List files in your workspace root
# -u email:api_key
$ curl -u you@example.com:dos_your_api_key \
    -X PROPFIND \
    -H "Depth: 1" \
    https://api.dosya.dev/webdav/mount/your_workspace_id/Your%20Workspace/

# The root lists six collections: All (your real, writable tree)
# plus Documents, Videos, Images, Shared and Deleted - flat,
# read-only views. Everything you write goes under All/.

# List a folder in your real tree
$ curl -u you@example.com:dos_your_api_key \
    -X PROPFIND \
    -H "Depth: 1" \
    https://api.dosya.dev/webdav/mount/your_workspace_id/Your%20Workspace/All/Reports/

# List a smart view - every PDF and doc in the workspace, flat
$ curl -u you@example.com:dos_your_api_key \
    -X PROPFIND \
    -H "Depth: 1" \
    https://api.dosya.dev/webdav/mount/your_workspace_id/Your%20Workspace/Documents/

Upload

# Upload a file. Writes go under All/ - the five type views
# (Documents, Videos, Images, Shared, Deleted) are read-only.
$ curl -u you@example.com:dos_your_api_key \
    -T ./report.pdf \
    https://api.dosya.dev/webdav/mount/your_workspace_id/Your%20Workspace/All/Reports/report.pdf

# Overwrite creates a new version automatically
$ curl -u you@example.com:dos_your_api_key \
    -T ./report-v2.pdf \
    https://api.dosya.dev/webdav/mount/your_workspace_id/Your%20Workspace/All/Reports/report.pdf

# Refuse to overwrite: 412 if the name is already taken
$ curl -u you@example.com:dos_your_api_key \
    -T ./report.pdf \
    -H "If-None-Match: *" \
    https://api.dosya.dev/webdav/mount/your_workspace_id/Your%20Workspace/All/Reports/report.pdf

Download

# Download a file
$ curl -u you@example.com:dos_your_api_key \
    -o report.pdf \
    https://api.dosya.dev/webdav/mount/your_workspace_id/Your%20Workspace/All/Reports/report.pdf

# Partial / resumable download (byte ranges)
$ curl -u you@example.com:dos_your_api_key \
    -H "Range: bytes=0-1048575" \
    -o report.pdf.part \
    https://api.dosya.dev/webdav/mount/your_workspace_id/Your%20Workspace/All/Reports/report.pdf

Manage files

# Create a folder
$ curl -u you@example.com:dos_your_api_key \
    -X MKCOL \
    https://api.dosya.dev/webdav/mount/your_workspace_id/Your%20Workspace/All/NewFolder/

# Delete a file
$ curl -u you@example.com:dos_your_api_key \
    -X DELETE \
    https://api.dosya.dev/webdav/mount/your_workspace_id/Your%20Workspace/All/old-file.txt

# Move / rename a file
$ curl -u you@example.com:dos_your_api_key \
    -X MOVE \
    -H "Destination: /webdav/mount/your_workspace_id/Your%20Workspace/All/Archive/old-file.txt" \
    https://api.dosya.dev/webdav/mount/your_workspace_id/Your%20Workspace/All/old-file.txt

# Copy a file
$ curl -u you@example.com:dos_your_api_key \
    -X COPY \
    -H "Destination: /webdav/mount/your_workspace_id/Your%20Workspace/All/backup.pdf" \
    https://api.dosya.dev/webdav/mount/your_workspace_id/Your%20Workspace/All/report.pdf

API key scopes

What each key scope can do

Operation	read	upload	full
PROPFIND (list)	✓	✕	✓
GET / HEAD (download)	✓	✕	✓
PUT (upload)	✕	✓	✓
MKCOL (create folder)	✕	✓	✓
LOCK / UNLOCK / PROPPATCH	✕	✓	✓
DELETE	✕	✕	✓
MOVE (rename)	✕	✕	✓
COPY	✕	✕	✓

Limitations

Listing depth	PROPFIND lists one folder level at a time (Depth 0 or 1) - no deep recursive listings.
Folder copy	COPY works on single files. To copy a folder, copy its files individually.
PROPPATCH	Accepted so clients don't error, but custom properties are not saved.
LOCK / UNLOCK	Locks are always granted and not enforced between clients. For safe concurrent edits, send If-Match with the file's ETag.
Locked files	Files locked in the dashboard can't be changed over WebDAV. Fully-locked files can't be downloaded either.
Rate limits	An abuse ceiling on request rate, on every plan: 600 requests per minute per user, 1,200 per minute per IP. It is not a usage quota and nothing is billed against it. Free credentials also carry the 60/minute fair-use limit, which binds first.