Skip to main content

Custom recording for an entry point

Enable/Disable custom recording for an entry point

Enables or disables custom recording for all live streams under the specified entry point.

After calling the Set custom recording configuration API, custom recording is automatically enabled for all live streams under the entry point.

HTTP request


_1
PATCH https://api.agora.io/v1/projects/{appid}/fls/entry_points/{entry_point}/settings/record/custom/auto

Path parameter

ParameterTypeDescription
appidStringRequired. The App ID retrieved from Agora Console.
entry_pointStringRequired. The entry point name.

Request body

The request body is in the JSON Object type, and contains the following fields:

FieldTypeDescription
enabledBoolRequired. Whether to enable custom recording for all live streams under the specified entry point.

HTTP response

If the returned HTTP status code is 200, the request is successful.

If the returned HTTP status code is not 200, the request fails. You can refer to the HTTP status codes for possible reasons.

Example

Request line


_1
PATCH https://api.agora.io/v1/projects/{your_appid}/fls/entry_points/live/settings/record/custom/auto HTTP/1.1

Request body


_3
{
_3
"enabled": false
_3
}

Response line


_1
HTTP/1.1 200 OK

HTTP status codes

Status codeDescription
200The request succeeds.
400The parameter is invalid, for example the appid or the entry_point is empty, or the region parameter value is invalid.
401Unauthorized (the customer ID and the customer secret do not match).
404The server cannot find the resource according to the request, which means the requested entry point does not exist or the requested URI path is invalid.
500An internal error occurs in the server, so the server is not able to complete the request.
504An internal error occurs in the server. The gateway or the proxy server did not receive a timely request from the remote server.

Page Content