Recording Error
If an error occurs during recording, or before a recording can be started, a recording.error
event may be emitted. You may still receive a recording.started
event, or recording.ready-to-download
event, depending on when the error was emitted during the recording lifecycle.
Webhook Events
There are five common fields all events share:
Represents the version of the event. This uses semantic versioning to inform a consumer if the payload has introduced any breaking changes.
Represents the type of the event described in the payload.
An identifier representing this specific event.
An object representing the event, whose fields are described below.
Documenting when the webhook itself was sent. This timestamp is different than the time of the event the webhook describes. For example, a recording.started event will contain a start_ts timestamp of when the actual recording started, and a slightly later event_ts timestamp indicating when the webhook event was sent.
Payload
The semantic version of the current message.
The Unix epoch time in seconds representing when the event was generated.
The payload of the object, describing the given event.
The error message returned.
The recording instance ID that was passed into the start recording command.
The name of the room where the recording was made.
The Unix epoch time in seconds representing when the error was emitted.