Deletes a draft of a video clip. Identify a draft by its system-defined ID.
Request
Request syntax:
DELETE /clipping_draft/Draft Clip ID
Use the Get All Draft Clips endpoint to retrieve a list of drafts and their system-defined IDs.
Response
The response for a successful request contains the following properties:
Name | Data Type | Description |
---|---|---|
@id | String | Indicates the relative path to this endpoint. |
@type | String | Returns ClippingDraft. |
message | String | Returns Deleted when the specified draft has been successfully deleted. |
Sample Request/Response
Call the delete_draft_clip module (Python 3) to delete a draft of a video clip. This module imports names from the api_auth module.
import json
import requests
from api_auth import APICredentials, APIParams
class DeleteDraftClip:
def __init__(self):
self.host = "https://services.uplynk.com"
def run(self):
"""
Deletes a draft of a video clip.
"""
self._delete_draft()
def _delete_draft(self):
draft_clip_id = 'abc0123def456ghi789klmno0123pqrs' # Replace with the desired draft clip ID.
url = "{}{}{}".format(self.host, "/api/v4/clipping_draft/", draft_clip_id)
response = requests.delete(
url, params=APIParams(APICredentials()).get_params({})
)
print(response.json())
DeleteDraftClip().run()
Response:
{
"message": "Deleted",
"@id": "/api/v4/clipping_draft/15b8de658a2e4149aa772de8c7d8b86d",
"@type": "ClippingDraft"
}