Requesting a token
Admin → Account management → select an account → Generate API token. The token is shown once, so store it safely.
Common endpoints
| Endpoint | Notes |
|---|---|
GET /api/v1/files | List a directory |
POST /api/v1/files/upload | Upload a file (chunked upload supported) |
GET /api/v1/files/{id}/download | Get a download URL |
POST /api/v1/shares | Create a controlled share link |
GET /api/v1/audit | Query audit records |
Requests must carry Authorization: Bearer <token>.
Mounting WebDAV
- Windows: map a network drive and use
https://your-domain/webdavas 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.