Hotlink Protection

Control Hotlink Protection rules for CDN Resources through the Security API.

Update Hotlink Protection settings for a CDN Resource

put

Use this endpoint to enable or disable Hotlink Protection for a CDN Resource. Define the allowed domains to prevent other sites from directly linking to your CDN-hosted assets. This setting is supported for Small, Large, and Streaming resource types.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
organization_uuidstringRequired

Unique identifier of the organization.

Example: 123e4567-e89b-12d3-a456-426614174000
resource_uuidstringRequired

Unique identifier of the CDN Resource.

Example: 789e1234-b56c-78d9-a123-526614174111
Body
resource_uuidstringRequired

Unique identifier of the CDN Resource.

Example: 789e1234-b56c-78d9-a123-526614174111
status_hl_protectionbooleanRequired

Enables or disables Hotlink Protection for the CDN Resource.

Example: true
hl_protection_domainsstring[]Required

List of allowed domains that can access CDN-hosted content.

Example: ["domain.test.com","domain2.test.com"]
Responses
put
/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}
PUT /api/v1/cdn/{organization_uuid}/resource/{resource_uuid} HTTP/1.1
Host: cloud.medianova.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 147

{
  "resource_uuid": "789e1234-b56c-78d9-a123-526614174111",
  "status_hl_protection": true,
  "hl_protection_domains": [
    "domain.test.com",
    "domain2.test.com"
  ]
}
200

Hotlink Protection settings updated successfully.

{
  "status": true,
  "data": {}
}

Last updated

Was this helpful?