v58

latestOpenAPI 3.0.3agplraw.githubusercontent.com2026-08-01187461.6 MB

recording

Store the recording

When a fileName is provided the recording is expected to have been uploaded already through a share requested with {@see self::requestUpload()}, and only the post-processing is run. Otherwise the recording is read from the multipart file upload. Required capability: recording-v1

post/ocs/v2.php/apps/spreed/api/{apiVersion}/recording/{token}/store

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 nullable

User that will own the recording file. null is actually not allowed and will always result in a "400 Bad Request". It's only allowed code-wise to handle requests where the post data exceeded the limits, so we can return a proper error instead of "500 Internal Server Error".

fileNamestring nullable

The sanitized file name returned by the request-upload request. When provided, no multipart file is expected.

Response

Recording stored successfully