Deletes one or more videos at a time, including their mezzanine files, transcoded stream files, and thumbnail snapshots.


  • This operation physically deletes videos. Deleted videos cannot be recovered. Exercise caution when you call this operation.
  • You can call this operation to delete multiple videos at a time.
  • When you delete a video, its source file, transcoded stream file, and thumbnail screenshot are also deleted. However, the Alibaba Cloud Content Delivery Network (CDN) cache is not refreshed simultaneously. You can use the refresh feature in the ApsaraVideo VOD console to clear garbage data on CDN nodes. For more information, see Refresh and prefetch.

QPS limit

You can call this operation up to 30 times per second per account. If the number of calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation. For more information, see QPS limit.


OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DeleteVideo

The operation that you want to perform. Set the value to DeleteVideo.

VideoIds String Yes e44ebf1147hdsa2d2adbea8b****,e44ebf11oj984adbea8****,73ab850b4f6f4b6e91d24d81d54****

The list of video IDs. Separate multiple IDs with commas (,). A maximum of 20 IDs can be specified. You can obtain a video ID in one of the following ways:

  • If the video is uploaded by using the ApsaraVideo VOD console, log on to the console and choose Media Files > Audio/Video to view the ID of the video.
  • If the video is uploaded by calling the CreateUploadVideo operation, the video ID is the VideoId value in the response.
  • You can also call the SearchMedia operation to obtain the video ID, which is the VideoId value in the response.

Response parameters

Parameter Type Example Description
RequestId String E4EBD2BF-5EB0-4476-8829-9D94E1B1****

The ID of the request.

ForbiddenVideoIds Array of String 73ab850b4f6f4b6e91d24d81d54****

The IDs of the videos that cannot be deleted.

Note Generally, videos cannot be deleted if you do not have the required permissions.
NonExistVideoIds Array of String e44ebf1147hdsa2d2adbea8b****

The IDs of the videos that do not exist.

Note If the list of videos to be deleted contains one or more videos that do not exist, the IDs of these non-existing videos are returned. If none of the videos in the list exists, a 404 error is returned.


Sample requests

&<Common request parameters>

Sample responses

XML format

HTTP/1.1 200 OK


JSON format

HTTP/1.1 200 OK

  "RequestId" : "E4EBD2BF-5EB0-4476-8829-9D94E1B1****",
  "ForbiddenVideoIds" : [ "73ab850b4f6f4b6e91d24d81d54****" ],
  "NonExistVideoIds" : [ "e44ebf1147hdsa2d2adbea8b****" ]

Error codes

For a list of error codes, visit the API Error Center.

Common errors

The following table describes the common errors that this operation can return.

Error code

Error message

HTTP status code



The VideoIds exceeded maximum.


The error message returned because the list of video IDs exceeds the maximum length.


The video does not exist.


The error message returned because the video does not exist.


Deleting video has failed due to some unknown error.


The error message returned because the system failed to delete the video. Try again later.

Sample code of SDKs for various languages

We recommend that you use a server-side SDK to call this operation. For more information about the sample code that is used to call this operation in various languages, see the following topics: