Uploads

Upload limits

Limits are applied by user role and per-request checks. Configure in runtime settings and .env.

Recommended checks:

• Reverse proxy body size limits
• Role-based limits for non-admin users
• Max files per upload for bulk operations

Chunked uploads

Large uploads use chunked mode to handle reverse-proxy limits and slow networks. The client negotiates chunk size via:

POST /api/v1/upload?action=init

Tags

Uploads accept tag IDs and new tag names:

• tagIds (JSON array of existing IDs)
• newTags (comma-separated new tag names)

Metadata fields

You can send:

• description
• folderName
• isPublic
• maxViews / maxViewsAction

Tips

• Use chunked uploads for unstable connections
• Keep previews enabled to improve vault scanning