Skip to main contentIBM Video Streaming Developers

Video metadata values

Get all metadata values of a video

Get all metadata values set for a selected video.

GET https://api.video.ibm.com/videos/{video_id}/custom-metadata.json

Parameters

This request has no parameters.

Success response

Upon success a response with HTTP status “200 OK” is returned with the following key-value pair.

KEYTYPEDESCRIPTION
metadataarrayArray of data for fields containing field_id and value

Example of a success response:

{
"metadata": [
{
"field_id": "8865",
"value": "some text"
},
{
"field_id": "8867",
"value": "false"

Error responses

Possible error responses:

HTTP RESPONSE CODEERROR VALUEERROR CONDITIONS
401 UnauthorizedThe provided access token is missing, revoked, expired or malformed
404 Not Foundnot_foundVideo not found
503 Service UnavailableThere is a temporary error on the server which makes it impossible to serve the request

Set video metadata value

Set value of a custom field for a selected video.

PUT https://api.video.ibm.com/videos/{video_id}/custom-metadata/{field_id}.json

Parameters

The parameters for the PUT request:

PARAMETERTYPEIMPORTANCEDESCRIPTION
value(mixed)*REQUIREDThe metadata field value

* Data type may vary based on selected field.

Success response

Upon success, a response with HTTP status “204 No Content” is returned.

Error responses

Possible error responses:

HTTP RESPONSE CODEERROR VALUEERROR CONDITIONS
401 UnauthorizedThe provided access token is missing, revoked, expired or malformed
403 Forbiddenlack_of_ownershipThe API user is not allowed to manage the given video
404 Not Foundnot_foundVideo not found
503 Service UnavailableThere is a temporary error on the server which makes it impossible to serve the request

Remove video metadata value

Remove a value from a custom field for a selected video.

DELETE https://api.video.ibm.com/videos/{video_id}/custom-metadata/{field_id}.json

Parameters

This request has no parameters.

Success response

Upon success a response with HTTP status “200 OK” is returned.

Error responses

Possible error responses:

HTTP RESPONSE CODEERROR VALUEERROR CONDITIONS
401 UnauthorizedThe provided access token is missing, revoked, expired or malformed
403 Forbiddenlack_of_ownershipThe API user is not allowed to manage the given video
404 Not Foundnot_foundVideo not found