v46

latestOpenAPI 3.0.3agplraw.githubusercontent.com2026-08-013364.0 KB
recording

Request a temporary upload share for a recording

Creates a password-protected public link share with create-only permissions on the per-room recording folder, so the recording backend can upload a large recording via the chunked public WebDAV API. Chunked uploading works the same way as it does for clients, documented in https://docs.nextcloud.com/server/latest/developer_manual/client_apis/WebDAV/chunking.html#chunked-upload-v2

  • Base URL: public.php/dav/uploads/$SHARETOKEN - HTTP user: share token - HTTP password: share password After the upload and assembling is finished call the /api/{apiVersion}/recording/{token}/store endpoint {@see self::store()} and provide the file name, to trigger the notification for the moderator. Required capability: recording-chunked-upload
post/ocs/v2.php/apps/spreed/api/{apiVersion}/recording/{token}/request-upload

Path parameters

apiVersion'v1' required
tokenstring required

Headers

talk-recording-randomstring

Random seed (at least 32 bytes) used together with the room token to generate the SHA256-HMAC request checksum

talk-recording-checksumstring

SHA256-HMAC checksum over the concatenation of the random seed and the room token, signed with the shared recording secret, to verify authenticity from the recording backend

OCS-APIRequestboolean required

Required to be true for the API request to pass

Request body

ownerstring required

User that will own the recording file.

fileNamestring required

Suggested file name of the recording. The extension must be one of the allowed recording formats.

Response

Upload share created successfully