The Media API provides operations for preparing uploads, completing uploads, converting audio, listing stored media, and streaming or downloading media files.
Endpoints
| Method | Path | Purpose |
| POST | /uploads/convert-audio | Convert WebM audio |
| POST | /uploads/presign | Generate upload URL |
| POST | /uploads/complete | Complete upload |
| GET | /uploads/Workspace/:workspaceId | List Workspace files |
| GET | /uploads/channel/:workspaceId/:channelId | List Channel files |
| GET | /media/file/:fileId | Stream media |
| GET | /media/info/:fileId | Get media information |
| GET | /media/download/:fileId | Download media |
| GET | /media/status | Get media storage status |
Presigned Uploads
The upload preparation request includes:
fileName
fileType
fileSize
conversationId
channelId
The response includes:
uploadUrl
publicUrl
fileId
s3Key
The s3Key is an implementation response field and should not be treated as a credential or exposed as an internal infrastructure configuration.
Need Help?
Email: support@ysdesk.com
Documentation: https://docs.ysplugins.com/ys-desk