Available in Classic and VPC
Delete the file recorded in a live channel. Deletion request deletes recordings temporarily stored in Live Station, but does not delete files uploaded to the Object Storage bucket.
Request
This section describes the request format. The method and URI are as follows:
Method | URI |
---|---|
DELETE | /api/v2/channels/{channelId}/records |
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
|
Request body
You can include the following data in the body of your request:
Field | Type | Required | Description |
---|---|---|---|
recordIds |
Array | Required | Recording file ID list |
Request example
The request example is as follows:
curl --location --request DELETE 'https://livestation.apigw.ntruss.com/api/v2/channels/ls-20250814******-PZohi/records' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'Content-Type: application/json' \
--header 'x-ncp-region_code: KR' \
--data '{
"recordIds": [
270****, 270****
]
}'
Response
This section describes the response format.
Response status codes
For information about the HTTP status codes common to all Live Station APIs, see Live Station response status codes.
Response example
If the response is successful, the recording file is deleted along with the message 200 OK
.