Page optimized for desktop experience. Please use a desktop browser for best compatibility.

Patch Video Metadata

Partially edits the metadata details of a video. You do not need to provide the fields that are not changing.

PATCH
/api/v2/videos/{videoId}

Usage Notes | Change Log

  • Only fields that are able to be modified by the PUT endpoint are allowed to be modified.
  • This endpoint sets only the attributes/values specified in the request. However, be aware that it does validate the entirety of the attribute list in the same way the Rev UI does. The most notable example is if you attempt to set an attribute (such as title) via the API and there is a required custom field that has not been set. In this case, the API will return an error and not set the value.
  • Attribute names MUST start with an Uppercase letter. Example: ApprovalStatus NOT approvalStatus.

Request Body

application/jsonpatch

Refer to http://jsonpatch.com/ for the format of the request body.

Patch operations on video non-editable fields [Id,ApprovalStatus,UploadedBy,WhenUploaded,LastViewed] will be ignored.

Operations supported:

  • add
  • remove
  • copy
  • replace
  • test
  • move

Add operation: {"op": "add", "path": "/Categories/0", "value": "03846100-96ac-4628-bbe3-b23a0df1081d"}

Replace operation:{"op": "replace", "path": "/accessControlEntities/0/CanEdit", "value": "false"}

Response Messages

Successful response

Unauthorized error

Conflict error

Internal server error