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"
}