Delete Draft Clip

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:

NameData TypeDescription
@idStringIndicates the relative path to this endpoint.
@typeStringReturns ClippingDraft.
messageStringReturns 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"
}