Updates the category to which a media file belongs.

Usage notes

You can call this operation to update only the category of a media file. For more information about how to update all the information about a media file, see UpdateMedia.

Limits on QPS

You can call this operation up to 100 times per second. 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 limits.


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 UpdateMediaCategory

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

MediaId String Yes 3e1cd21131a94525be55acf65888****

The ID of the media file whose category you want to update.

Note To obtain the ID of a media file, you can call the AddMedia operation. Alternatively, perform the following operations in the ApsaraVideo Media Processing (MPS) console: In the left-side navigation pane, choose Media Management > Media List. Find the required video and click Manage. The ID of the video is displayed on the Basics tab.
CateId Long No 1

The ID of the category. The value cannot be negative.

Response parameters

Parameter Type Example Description
RequestId String E3931857-E3D3-4D6E-9C7B-D2C09441BD01

The ID of the request.


Sample requests

&<Common request parameters>

Sample success responses

XML format

HTTP/1.1 200 OK


JSON format

HTTP/1.1 200 OK

  "RequestId" : "E3931857-E3D3-4D6E-9C7B-D2C09441BD01"

Error codes

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