Skip to main content
DELETE
/
videolibrary
/
{id}
Delete Video Library
curl --request DELETE \
  --url https://api.bunny.net/videolibrary/{id} \
  --header 'AccessKey: <api-key>'
{
  "Id": 123,
  "Name": "<string>",
  "VideoCount": 123,
  "TotalCount": 123,
  "TrafficUsage": 123,
  "StorageUsage": 123,
  "DateCreated": "2023-11-07T05:31:56Z",
  "DateModified": "2023-11-07T05:31:56Z",
  "ReplicationRegions": [
    "<string>"
  ],
  "ApiKey": "<string>",
  "ReadOnlyApiKey": "<string>",
  "HasWatermark": true,
  "WatermarkPositionLeft": 123,
  "WatermarkPositionTop": 123,
  "WatermarkWidth": 123,
  "PullZoneId": 123,
  "StorageZoneId": 123,
  "WatermarkHeight": 123,
  "EnabledResolutions": "<string>",
  "ViAiPublisherId": "<string>",
  "VastTagUrl": "<string>",
  "WebhookUrl": "<string>",
  "CaptionsFontSize": 123,
  "CaptionsFontColor": "<string>",
  "CaptionsBackground": "<string>",
  "UILanguage": "<string>",
  "AllowEarlyPlay": true,
  "PlayerTokenAuthenticationEnabled": true,
  "AllowedReferrers": [
    "<string>"
  ],
  "BlockedReferrers": [
    "<string>"
  ],
  "BlockNoneReferrer": true,
  "EnableMP4Fallback": true,
  "KeepOriginalFiles": true,
  "AllowDirectPlay": true,
  "EnableDRM": true,
  "DrmVersion": 0,
  "AppleFairPlayDrm": {
    "Enabled": true,
    "CertificateId": 123,
    "CertificateExpirationDate": "2023-11-07T05:31:56Z",
    "Provider": "<string>"
  },
  "GoogleWidevineDrm": {
    "Enabled": true,
    "CertificateId": 123,
    "CertificateExpirationDate": "2023-11-07T05:31:56Z",
    "Provider": "<string>",
    "SdOnlyForL3": true,
    "MinClientSecurityLevel": 0
  },
  "Bitrate240p": 123,
  "Bitrate360p": 123,
  "Bitrate480p": 123,
  "Bitrate720p": 123,
  "Bitrate1080p": 123,
  "Bitrate1440p": 123,
  "Bitrate2160p": 123,
  "ApiAccessKey": "<string>",
  "ShowHeatmap": true,
  "EnableContentTagging": true,
  "PullZoneType": 0,
  "CustomHTML": "<string>",
  "Controls": "<string>",
  "PlaybackSpeeds": "<string>",
  "PlayerKeyColor": "<string>",
  "FontFamily": "<string>",
  "WatermarkVersion": 123,
  "EnableTranscribing": true,
  "EnableTranscribingTitleGeneration": true,
  "EnableTranscribingDescriptionGeneration": true,
  "EnableTranscribingChaptersGeneration": true,
  "EnableTranscribingMomentsGeneration": true,
  "TranscribingCaptionLanguages": [
    "<string>"
  ],
  "EnableCaptionsInPlaylist": true,
  "RememberPlayerPosition": true,
  "EnableMultiAudioTrackSupport": true,
  "UseSeparateAudioStream": true,
  "JitEncodingEnabled": true,
  "EncodingTier": 0,
  "OutputCodecs": "<string>",
  "DrmBasePriceOverride": 123,
  "DrmCostPerLicenseOverride": 123,
  "TranscribingPriceOverride": 123,
  "PremiumEncodingPriceOverride": 123,
  "MonthlyChargesTranscribing": 123,
  "MonthlyChargesPremiumEncoding": 123,
  "MonthlyChargesEnterpriseDrm": 123,
  "FeatureFlags": "<string>",
  "PlayerVersion": 123,
  "RemoveMetadataFromFallbackVideos": true,
  "ScaleVideoUsingBothDimensions": true,
  "ExposeOriginals": true,
  "ExposeVideoMetadata": true
}

Authorizations

AccessKey
string
header
required

API Access Key authorization header

Path Parameters

id
integer<int64>
required

The ID of the Video Library that should be deleted

Response

The requested video library has been successfuly deleted

Id
integer<int64>
Name
string | null

The name of the Video Library.

VideoCount
integer<int64>

The number of videos in the video library

TotalCount
integer<int64>

The total number of items contained by the video library

TrafficUsage
integer<int64>

The amount of traffic usage this month

StorageUsage
integer<int64>

The total amount of storage used by the library

DateCreated
string<date-time>

The date when the video library was created

DateModified
string<date-time>

The date when the video library was last modified

ReplicationRegions
string[] | null

The geo-replication regions of the underlying storage zone

ApiKey
string | null

The API key used for authenticating with the video library

ReadOnlyApiKey
string | null

The read-only API key used for authenticating with the video library

HasWatermark
boolean

Determines if the video library has a watermark configured

WatermarkPositionLeft
integer<int32>

The left offset of the watermark position (in %)

WatermarkPositionTop
integer<int32>

The top offset of the watermark position (in %)

WatermarkWidth
integer<int32>

The width of the watermark (in %)

PullZoneId
integer<int64>

The ID of the connected underlying pull zone

StorageZoneId
integer<int64>

The ID of the connected underlying storage zone

WatermarkHeight
integer<int32>

The height of the watermark (in %)

EnabledResolutions
string | null

The comma separated list of enabled resolutions

ViAiPublisherId
string | null

The vi.ai publisher id for advertising configuration

VastTagUrl
string | null

The URL of the VAST tag endpoint for advertising configuration

WebhookUrl
string | null

The webhook URL of the video library

CaptionsFontSize
integer<int32>

The captions display font size

CaptionsFontColor
string | null

The captions display font color

CaptionsBackground
string | null

The captions display background color

UILanguage
string | null

The UI language of the player

AllowEarlyPlay
boolean | null

Determines if the Early-Play feature is enabled

PlayerTokenAuthenticationEnabled
boolean

Determines if the player token authentication is enabled

AllowedReferrers
string[] | null

The list of allowed referrer domains allowed to access the library

BlockedReferrers
string[] | null

The list of blocked referrer domains blocked from accessing the library

BlockNoneReferrer
boolean

Determines if the requests without a referrer are blocked

EnableMP4Fallback
boolean

Determines if the MP4 fallback feature is enabled

KeepOriginalFiles
boolean

Determines if the original video files should be stored after encoding

AllowDirectPlay
boolean

Determines direct play URLs are enabled for the library

EnableDRM
boolean

Determines if the DRM is enabled

DrmVersion
enum<integer>

DRM version (basic or enterprise)

Available options:
0,
1,
2
AppleFairPlayDrm
object

Described Apple FairPlay DRM

GoogleWidevineDrm
object

Describes Google Widevine DRM

Bitrate240p
integer<int32>

The bitrate used for encoding 240p videos

Bitrate360p
integer<int32>

The bitrate used for encoding 360p videos

Bitrate480p
integer<int32>

The bitrate used for encoding 480p videos

Bitrate720p
integer<int32>

The bitrate used for encoding 720p videos

Bitrate1080p
integer<int32>

The bitrate used for encoding 1080p videos

Bitrate1440p
integer<int32>

The bitrate used for encoding 1440p videos

Bitrate2160p
integer<int32>

The bitrate used for encoding 2160p videos

ApiAccessKey
string | null
deprecated
ShowHeatmap
boolean

Determines if the video watch heatmap should be displayed in the player.

EnableContentTagging
boolean

Determines if content tagging should be enabled for this library.

PullZoneType
enum<integer>

The type of the pull zone attached. Premium = 0, Volume = 1

Available options:
0,
1
CustomHTML
string | null

The custom HTMl that is added into the head of the HTML player.

Controls
string | null

The list of controls on the video player.

PlaybackSpeeds
string | null

The list of playback speeds available in the video player.

PlayerKeyColor
string | null

The key color of the player.

FontFamily
string | null

The captions font family.

WatermarkVersion
integer<int64>
EnableTranscribing
boolean

Determines if the automatic audio transcribing is currently enabled for this zone.

EnableTranscribingTitleGeneration
boolean

Determines if automatic transcribing title generation is currently enabled.

EnableTranscribingDescriptionGeneration
boolean

Determines if automatic transcribing description generation is currently enabled.

EnableTranscribingChaptersGeneration
boolean

Determines if automatic transcribing chapters generation is currently enabled.

EnableTranscribingMomentsGeneration
boolean

Determines if automatic transcribing moments generation is currently enabled.

TranscribingCaptionLanguages
string[] | null

The list of languages that the captions will be automatically transcribed to.

EnableCaptionsInPlaylist
boolean | null

Determines if any associated captions will be automatically signaled in the HLS master playlist via EXT-X-MEDIA tags, allowing client players to show captions.

RememberPlayerPosition
boolean

Determines if the player will automatically remember the playback position.

EnableMultiAudioTrackSupport
boolean

Determines if multiple output audio track support is enabled on video library.

UseSeparateAudioStream
boolean

Determines whether output audio stream should be split from video stream segments.

JitEncodingEnabled
boolean

Determines whether JIT encoding should be used for the library. Supported in premium encoding only.

EncodingTier
enum<integer>

Defines encoding tier to be used with video library. premium is a paid tier that offers either JIT encoding or prioritized encoding and extra codec support.

Available options:
0,
1
OutputCodecs
string | null

Specifies which video codecs are used for encoding, provided as a comma-separated (CSV) string. Free encoding tier supports only x264. A premium encoding tier adds support for vp9, hevc, and av1.

DrmBasePriceOverride
number<decimal> | null

DRM (enterprise) monthly base price for this video library if it differs from list price.

DrmCostPerLicenseOverride
number<decimal> | null

DRM (enterprise) cost per license for this video library if it differs from list price.

TranscribingPriceOverride
number<decimal> | null
PremiumEncodingPriceOverride
number<decimal> | null
MonthlyChargesTranscribing
number<decimal>
MonthlyChargesPremiumEncoding
number<decimal>
MonthlyChargesEnterpriseDrm
number<decimal>
FeatureFlags
string | null
PlayerVersion
integer<int32>
RemoveMetadataFromFallbackVideos
boolean

Marks whether all potential video metadata should be removed from the fallback files. Default false.

ScaleVideoUsingBothDimensions
boolean

Marks whether videos should be scaled using both dimensions. Prevents videos being upscaled or unexpected aspect ratio changes. Default true.

ExposeOriginals
boolean

Marks whether original video files should be exposed via CDN.

ExposeVideoMetadata
boolean

Marks whether video metadata in form of schema meta tags and LD+JSON should be exposed.