Prepare Recording Upload

Create a recording and return a one-hour direct-upload request.

Authentication

AuthorizationBearer

Revero-owned OAuth 2.0 Client Credentials. Obtain tokens only from a backend; never place the client secret in browser code.

Path parameters

meeting_idstringRequiredformat: "uuid"

Request

This endpoint expects an object.
content_typestringOptional<=100 charactersDefaults to audio/webm

MIME type of the audio. The presigned request is issued for exactly this type, and completion refuses an object whose stored type differs — send the same value as the Content-Type header on your upload.

Response

A recording resource and its short-lived direct-upload instruction.

idstringformat: "uuid"
Revero's identifier for this recording.
meeting_idstringformat: "uuid"
The meeting this recording belongs to.
statusenum
Ingest state. Terminal values will not change again.
content_typestring
The MIME type declared when the upload was prepared.
created_atdatetime
When the upload was prepared.
updated_atdatetime
When this resource last changed.
uploadobject
This is the only part of the response safe to give browser code.
size_bytesinteger or nullOptional
Size of the uploaded object as Revero verified it. Null until the upload has been completed.
uploaded_atdatetime or nullOptional

When Revero verified the object in storage — not when your browser finished sending it. Null until completion.

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
415
Unsupported Media Type Error
422
Unprocessable Entity Error