Open API and WebDAV integration

Request an access token, call the common endpoints, and mount WebDAV in your file manager.

Requesting a token

Admin → Account management → select an account → Generate API token. The token is shown once, so store it safely.

Common endpoints

EndpointNotes
GET /api/v1/filesList a directory
POST /api/v1/files/uploadUpload a file (chunked upload supported)
GET /api/v1/files/{id}/downloadGet a download URL
POST /api/v1/sharesCreate a controlled share link
GET /api/v1/auditQuery audit records

Requests must carry Authorization: Bearer <token>.

Mounting WebDAV

  • Windows: map a network drive and use https://your-domain/webdav as the address
  • macOS: Finder → Go → Connect to server, then enter the same address
  • Linux: mount -t davfs https://your-domain/webdav /mnt/selfhub

Advice

For production integrations use a dedicated service account with a limited permission scope and rotate the token regularly.

Copy a link to this page