OCT-103 Gumlet outreach
POST/video/asset/recover

Recover a deleted video asset

Recovers a deleted video asset from the recycle bin. Supply the asset identifier in asset_id to select the asset to restore. A 200 response confirms the recovery request.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 body field

The identifier of the deleted video asset to recover. asset_id is required.

asset_idstringrequired

Gumlet Video Asset Id which needs to be recovered.

5 status codes
200Returns an empty response confirming the recovery request.
400Returned when the asset ID is invalid or missing.

One documented failure

  • asset_id_not_valid

    The asset ID is 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 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 missing or was deleted more than 30 days ago.

One documented failure

  • asset_created_before_last_30_days

    It's been more than 30 days since the asset was deleted. Please contact support for further assistance.

errorobjectrequired

Error handling

A 400 is returned when the asset ID is invalid or missing, a 401 when the API key or bearer token is missing or invalid, a 403 for an unpaid account or insufficient role permissions, and a 404 when the asset is missing or was deleted more than 30 days ago. asset_id is required and must identify the asset to recover.