OCT-103 Gumlet outreach
DELETE/video/assets/{asset_id}

Delete a video asset

Deletes a video asset by its identifier and removes it from storage. Use this operation when you no longer need the asset. Its associated URLs become inaccessible after deletion.

1 parameter
asset_idstringrequired

The identifier of the video asset to delete.

5 status codes
204Returns no response body after the asset is deleted.
400Returned when the asset ID is invalid.

One documented failure

  • asset_id_not_valid

    The asset ID is not valid.

errorobjectrequired
401Returned when the request is unauthorized.

One documented failure

  • asset_not_found

    Could not find any video asset with specified asset_id.

errorobjectoptional
403Returned when the account is unpaid or the authenticated user lacks the required role permissions.

One documented failure

  • unauthorized

    You don't have access to this feature. Please contact your organization owner.

errorobjectrequired
404Returned when the asset is not found.

One documented failure

  • asset_not_found

    Could not find any video asset with specified asset_id.

errorobjectrequired

Error handling

A 400 is returned for an invalid asset ID, a 401 for an unauthorized request, a 403 when the account is unpaid or the authenticated user lacks the required role permissions, and a 404 when the asset is not found. The asset_id path parameter must identify the asset to delete.