Skip to main content

Delete an asset (and its bytes, if managed)

DELETE 
/program/api/v2/projects/:projectID/assets/:assetID
warning

This endpoint is available in private cloud only. Use your global host URL if self-hosted.

For managed assets, the B2 object is deleted FIRST. Only if that succeeds is the DB row removed — leaves the row intact on B2 delete failure so the user can retry rather than discovering an orphan B2 object later. For BYO assets, only the row is removed (program never owned the bytes).

FK CASCADE removes any stream_assets join rows referencing this asset across all streams.

Idempotent on already-absent.

Generate JWT

Request​

Responses​

Asset deleted (or already absent)

Forbidden — no project access

Internal Server Error (e.g. B2 delete failed; row was NOT deleted)