Stop recording

Available in Classic and VPC

End recording on a live channel that is recording.

Request

This section describes the request format. The method and URI are as follows:

Method	URI
PUT	/api/v2/channels/{channelId}/stopRecord

Request headers

For information about the headers common to all Live Station APIs, see Live Station request headers.

Request path parameters

You can use the following path parameters with your request:

Field	Type	Required	Description
`channelId`	String	Required	Channel ID See Get channel list.

Request example

The request example is as follows:

curl --location --request PUT 'https://livestation.apigw.ntruss.com/api/v2/channels/ls-20250814******-PZohi/stopRecord' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'x-ncp-region_code: KR'

Response

This section describes the response format.

Response body

The response body includes the following data:

Field	Type	Required	Description
`content`	Object	-	Response result
`content.recordList`	Object	-	Recording file list
`content.recordList.{recordId}`	Object	-	Recording file information `{recordId}`: Recording file ID
`content.recordList.{recordId}.recordType`	String	-	Recording file type `MP4` \| `HLS`
`content.recordList.{recordId}.channelId`	String	-	Channel ID
`content.recordList.{recordId}.status`	String	-	File status `RECORDING` \| `PROCESSING` \| `PROCESSING_FAIL` \| `TRANSFER_READY` \| `TRANSFER` \| `TRANSFER_FINISH` \| `TRANSFER_FAIL` \| `DELETED` `RECORDING`: Recording `PROCESSING`: Processing `PROCESSING_FAIL`: Processing failed `TRANSFER_READY`: Transfer pending `TRANSFER`: Transferring `TRANSFER_FINISH`: Transfer completed `TRANSFER_FAIL`: Transfer failed `DELETED`: Deleted
`content.recordList.{recordId}.recordSeq`	Integer	-	Recording file sequence number
`content.recordList.{recordId}.streamSeq`	Integer	-	Stream sequence number
`content.recordList.{recordId}.recordBeginTime`	Integer	-	Recording start date and time (millisecond) Unix timestamp format
`content.recordList.{recordId}.createdTime`	Integer	-	Recording file creation date and time (millisecond) Unix timestamp format
`content.recordList.{recordId}.shouldDeleteTime`	Integer	-	Recording file deletion date and time (millisecond) Unix timestamp format
`content.recordList.{recordId}.resolution`	String	-	Resolution `{Width}x{Height}` format
`content.recordList.{recordId}.fileName`	String	-	File name
`content.recordList.{recordId}.duration`	Integer	-	Playback time (millisecond)
`content.recordList.{recordId}.videoBitrate`	Integer	-	Video stream's bitrate (bps)
`content.recordList.{recordId}.audioBitrate`	Integer	-	Audio stream's bitrate (bps)
`content.recordList.{recordId}.videoFrameRate`	Float	-	Number of frames per second (fps)
`content.recordList.{recordId}.audioCodec`	String	-	Audio codec
`content.recordList.{recordId}.objectStorageUrl`	String	-	Recording URL If it hasn't been uploaded to the Object Storage bucket, `-` is displayed.
`total`	Integer	-	Total number of recording files

Response status codes

For information about the HTTP status codes common to all Live Station APIs, see Live Station response status codes.

Response example

The response example is as follows:

{
    "content": {
        "recordList": {
            "270****": {
                "recordType": "MP4",
                "channelId": "ls-20250814******-PZohi",
                "status": "PROCESSING",
                "recordSeq": 1307133,
                "streamSeq": 361545,
                "recordBeginTime": 1755498175000,
                "createdTime": 1755498313000,
                "shouldDeleteTime": 1755757513000,
                "resolution": "720x1280",
                "fileName": "361545-1307133-20250818****.mp4",
                "duration": 137590,
                "videoBitrate": 2500000,
                "audioBitrate": 128000,
                "videoFrameRate": 30.0,
                "audioCodec": "aac",
                "objectStorageUrl": "-"
            },
            "270****": {
                "recordType": "HLS",
                "channelId": "ls-20250814******-PZohi",
                "status": "PROCESSING",
                "recordSeq": 1307133,
                "streamSeq": 361545,
                "recordBeginTime": 1755498175000,
                "createdTime": 1755498313000,
                "shouldDeleteTime": 1755757513000,
                "resolution": "720x1280",
                "fileName": "720p-9-16/playlist.m3u8",
                "videoBitrate": 2500000,
                "audioBitrate": 128000,
                "videoFrameRate": 30.0,
                "audioCodec": "AAC",
                "objectStorageUrl": "-"
            },
            "270****": {
                "recordType": "HLS",
                "channelId": "ls-20250814******-PZohi",
                "status": "PROCESSING",
                "recordSeq": 1307133,
                "streamSeq": 361545,
                "recordBeginTime": 1755498175000,
                "createdTime": 1755498313000,
                "shouldDeleteTime": 1755757513000,
                "resolution": "1920x1080",
                "fileName": "quality000/playlist.m3u8",
                "videoBitrate": 8960000,
                "audioBitrate": 320000,
                "videoFrameRate": 60.0,
                "audioCodec": "AAC",
                "objectStorageUrl": "-"
            }
        }
    },
    "total": 3
}