VideohatiDocs
API referenceVideos

Soft-delete a video

Soft-delete a video

DELETE/v1/videos/{id}

Sets deleted_at and aborts any active upload session. Requires an API key with write scope. Rate limit: 60 requests per 60 s per caller.

Error codes: unauthorized (401), insufficient_scope (403), account_not_approved (403), invalid_project_id (400), not_found (404).

Authentication

  • apiKey — Project API key: Authorization: Bearer vh_live_... (live mode) or Authorization: Bearer vh_test_... (test mode). Keys carry read and/or write scopes.

Parameters

NameInTypeRequiredDescription
idpathstring (Ulid)Yes

Request body

This operation takes no request body.

Responses

StatusMeaning
204Video soft-deleted.
400The request body or query failed validation. The per-operation description lists the exact error.code values.
401No valid credential was presented.
403The credential is valid but does not permit this action. The per-operation description lists the exact error.code values.
404The resource does not exist or is not visible to this caller.
429Rate limit exceeded.

Try it

DELETE
/v1/videos/{id}
Test mode only

API playground

Send a live request to api.videohati.com with a test-mode key.

This playground blocks vh_live_ keys. Use a key that starts with vh_test_ only; a request with a live key never leaves your browser.

The key is stored in your browser on docs.videohati.com only.