Media
The workspace's media and file library (doc 60) — folders, visibility, direct uploads to object storage, versions, trash, and the per-channel table of what a file must look like to be sent.
Stage a library file for a public reply under a comment
The platform check (which kinds a reply may carry) runs on the reply itself, as with an uploaded file.
The workspace's media library
Files an agent, a saved reply or a flow sends over and over — the price
Add files to the library through the server
The original multipart upload, kept for compatibility and for clients that cannot PUT to object storage. New clients use the direct upload (`POST /api/media/uploads`). Requires `media.upload`.
Limits, accepted types, quota and this member's library abilities
Limits, accepted types, quota and this member's library abilities
What each channel will carry (bytes, formats, pixels)
The single table the picker reads (doc 60 §6). `enforced` lists what the server refuses on send (bytes and kind); `advisory` what the panel only warns about, because the sender converts much of it (HEIC to JPEG, video re-encoding on WhatsApp).
Labels used on the files this member can see
Labels used on the files this member can see
One action on many files
Each file is authorised on its own; a refusal is reported in `skipped` rather than failing the request.
Keep a conversation or contact attachment in the library
By reference — the library row points at the attachment's own object, no byte is copied. Requires `media.upload` and access to where the file came from.
The folder tree, flat, with visible file counts
The folder tree, flat, with visible file counts
Create a folder (media.folders_manage)
Create a folder (media.folders_manage)
Rename or move a folder
Rename or move a folder
Remove a folder; its files and sub-folders move up one level
Remove a folder; its files and sub-folders move up one level
Start a direct upload
Reserves a storage key and returns where the browser PUTs the bytes —
Cancel an upload that was started
Cancel an upload that was started
Finish a direct upload
The server checks what arrived: size equal to the announced size, type sniffed from the bytes, allowed and coherent with the announced type. Anything else is deleted and refused.
Signed upload target for media-library files on disks that cannot presign (development)
Only ever handed out by `POST /api/media/uploads`; the signature binds the key.
One file, with its versions and where it is in live use
One file, with its versions and where it is in live use
Rename, describe, tag, file or re-share
Rename, describe, tag, file or re-share
Move a file to the trash
Restorable for the retention window, then purged. A message that already carried the file keeps its own row and its bytes.
Bring a file back from the trash
Bring a file back from the trash
Delete a file permanently
Delete a file permanently
Star a file (per member)
Star a file (per member)
Unstar a file
Unstar a file
Redirect to a signed download url
Redirect to a signed download url
Start uploading an edited image (or a trimmed / compressed video) as the next version
Start uploading an edited image (or a trimmed / compressed video) as the next version
Make the uploaded edit the current version (the id never changes)
Make the uploaded edit the current version (the id never changes)
Go back to an earlier version (the current one is kept as history)
Go back to an earlier version (the current one is kept as history)