Skip to main content
POST
Cleanup unconfigured resolutions

Authorizations

AccessKey
string
header
required

AccessKey based authentication

Path Parameters

libraryId
integer<int64>
required

The ID of the video library.

videoId
string
required

The GUID of the video.

Query Parameters

resolutionsToDelete
string | null

Comma-separated list of specific resolutions to delete (e.g. "720p,480p"), instead of relying on deleteNonConfiguredResolutions/allResolutions.

deleteNonConfiguredResolutions
boolean
default:false

If set to true, all resolutions not currently configured for the library will be deleted.

allResolutions
boolean
default:false

If set to true, all resolutions for the video will be deleted, regardless of library configuration. When targeting HLS resolutions (the default, or outputs=all), at least one resolution must remain after cleanup or the request is rejected — scope outputs to mp4 to remove every rendition.

deleteOriginal
boolean
default:false

If set to true, the original source file is deleted as well. Note: the original is also deleted when the library has 'keep original files' disabled, regardless of this flag.

outputs
string | null

Outputs to clean. Supported values: hls, mp4, all

deleteMp4Files
boolean
default:false

If set to true, MP4 fallback files for the deleted resolutions are removed too.

dryRun
boolean
default:false

If set to true, no actual file manipulation will happen, only informational data will be returned

Response

The resolutions were successfully deleted

success
boolean

Determines if the request was successful

message
string | null

Human-readable message describing the result, typically populated with error details when Success is false.

statusCode
integer<int32>

The HTTP status code corresponding to the result of the request.

data
object | null

The response payload. Some endpoints also populate this with error details when Success is false — see the endpoint's own response documentation.

Last modified on September 10, 2026