SKskilljar
Assets

Delete asset

Changed on

Permanently delete an asset.

Returns 409 when the asset is still used by live course content — as a lesson's content, a lesson content item, a lesson attachment, or a course promo video. Otherwise the asset is deleted and 204 is returned.

This is a hard delete. Unlike web packages, assets are not soft-deleted: the record is removed and its JW Platform video and stored file are torn down with it. There is no recovery.

By-id rather than a batch envelope: the conflict outcome has no natural home in a per-row batch result, and batch-responses.md warns against letting a ConflictError fall through the document-level path mid-batch. Matches DELETE /v2/web-packages/{id}.

Required OAuth scope: assets:write

delete/v2/assets/{id}

Request

Path parameters

idstring required

Response

No Content

Changes

  • bed169429eb2Revision changes
    • info

      added the non-success response with the status

  • 9fc34e55336dRevision changes
    • info

      media type application/json was changed to a more specific media type application/vnd.api+json for the response status

    • info

      media type application/json was changed to a more specific media type application/vnd.api+json for the response status

    • info

      media type application/json was changed to a more specific media type application/vnd.api+json for the response status

    • info

      media type application/json was changed to a more specific media type application/vnd.api+json for the response status

    • info

      media type application/json was changed to a more specific media type application/vnd.api+json for the response status