logo
On this page

Update the whiteboard


Description

You can call this method to update the whiteboard at any time during the recording.

We recommend that you call the UpdateWhiteboard method to update the whiteboard ID upon whiteboard switchover during the recording.

Request method and endpoint

  • Request method: POST
  • Request URL: https://cloudrecord-api.zego.im/?Action=UpdateWhiteboard
  • Transmission protocol: HTTPS
  • Rate limit: 10 requests/second

Request parameters

Listed below are the parameters specific to this request. For the list of common request parameters, see Accessing Server APIs - Common parameters.

ParameterTypeRequiredDescription
TaskIdIntYesTask ID. The value is a 16-byte character string.
WhiteboardIdStringYesWhiteboard ID.

Sample request

  • Request URL
    Untitled
    https://cloudrecord-api.zego.im/?Action=UpdateWhiteboard
    &AppId=1234567890
    &SignatureNonce=15215528852396
    &Timestamp=1234567890
    &Signature=7a2c0f11145fb760d607a07b54825013
    &SignatureVersion=2.0
    
    1
    Copied!
  • Request message body
    Untitled
    {
        "TaskId": "xxxx",
        "WhiteboardId": "1111"
    }
    
    1
    Copied!

Response parameters

ParameterTypeDescription
CodeInt64Return code.
MessageStringDescription of the request execution result.
RequestIdStringRequest ID.

Sample response

Untitled
{
    "Code": 0,
    "Message": "succeed",
    "RequestId": "abcd123"
}
1
Copied!

Previous

Update the mixed stream layout

Next

Query recording status