DELETE/video/assets/bulk/delete

Delete multiple video assets

Deletes multiple video assets in one request. Supply the asset_list and the workspace_id to identify the assets and their workspace. Use workspace_id instead of the deprecated source_id.

3 body fields

Bulk deletion request identifying the assets and workspace. Include asset_list and workspace_id.

asset_listarray<string>required

LIst of asset ids to delete

source_idstringdeprecatedoptional

Deprecated. Use workspace_id instead. Still accepted for backwards compatibility.

workspace_idstringrequired

Gumlet video workspace ID. Preferred over deprecated collection_id / source_id (same ID).

5 status codes
200Returns a success boolean indicating whether the deletion was successful.
successbooleanrequired

Boolean parameter indicating if the delete was successful.

400Returned when the request is invalid.

One documented failure

  • assets_id_not_valid

    One or more asset IDs in asset_list are not valid.

errorobjectrequired
401Returned when the API key or bearer token is missing or invalid.

One documented failure

  • invalid_api_key

    API key supplied with request is invalid

errorobjectrequired
403Returned when the account has unpaid dues 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
500Returned when an internal server error occurs.

One documented failure

  • internal_server_error

    We have encountered some server error. We have been notified and will fix it soon.

errorobjectrequired

Error handling

A 400 is returned when the request is invalid; include asset_list and workspace_id in the body. A 401 is returned when the API key or bearer token is missing or invalid. A 403 is returned when the account has unpaid dues or the authenticated user lacks the required role permissions. A 500 indicates an internal server error.