DELETE imcc/v1/media/
Delete a media object. Optionally delete any segments linked to it too.
Resource URL
https://{MEDIACONTROLCENTRE_HOST}[:PORT]/imcc/v1/media/
Resource Information
Response formats | XML (default) or JSON |
Requires authentication? | Yes (user context only) |
Required scope | modifyUsersData |
Parameters
Media ID
required
ID of media object.
Delete segments
1 to delete segments linked to the media object (defaults to 0).
Response
Returns "success" in XML (default) OR JSON if your standard HTTP Accept header specified application/json. Returns standard error response on failure.
Example Request - XML
curl -i -H "X-Imagen-API-Key: {APPLICATION API KEY}" \
-H "Authorization: Bearer {ACCESS_TOKEN}" \
-X DELETE https://{MEDIACONTROLCENTRE_HOST}[:PORT]/imcc/v1/media/111/1
Example Result - XML
<?xml version="1.0" encoding="UTF-8"?>
<Response>
<Result>success</Result>
</Response>
Example Request - JSON
curl -i -H "X-Imagen-API-Key: {APPLICATION API KEY}" \
-H "Authorization: Bearer {ACCESS_TOKEN}" \
-H "Accept: application/json" \
-X DELETE https://{MEDIACONTROLCENTRE_HOST}[:PORT]/imcc/v1/media/111/1
Example Result - JSON
{
"result": "success"
}