Resources

Create, view, update, and delete CDN resources. Use these endpoints to provision a CDN resource, configure its source (CDN Storage or origin), and manage its lifecycle.

Get CDN resource details

get

Retrieve configuration and status details for a specific CDN resource within an organization.

Authorizations

BearerAuth

AuthorizationstringRequired

Send the access token as a Bearer token in the Authorization header.

Path parameters

organization_uuidstring · uuidRequired

The organization UUID.

Example: 2f6c4f3a-2c48-4c2b-8e13-7d7c0f4e9b2a

resource_uuidstring · uuidRequired

The resource UUID.

Example: 8c3a1a2e-1a5a-4a4a-9d2f-3b2f9a5b9c11

Responses

200

Resource details retrieved successfully.

application/json

404

Resource not found.

application/json

get

/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}

HTTPcURLJavaScriptPython

GET /api/v1/cdn/{organization_uuid}/resource/{resource_uuid} HTTP/1.1
Host: cloud.medianova.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "status": true,
  "data": {
    "resource_uuid": "8c3a1a2e-1a5a-4a4a-9d2f-3b2f9a5b9c11",
    "resource_name": "test1.sm",
    "resource_type": "small",
    "resource_platform_type": "cache",
    "cdn_url": "test1.sm.mncdn.com",
    "protocol": "https",
    "origin_url": "test.com",
    "status": "active",
    "updating_status": "up_to_date",
    "created_at": "2024-09-12T09:23:26.000000Z",
    "updated_at": "2024-09-16T10:41:41.000000Z"
  }
}

Create a CDN Storage resource

post

Create a CDN resource that uses CDN Storage as its origin. Select the resource type (small or large) and provide the storage path configuration.

Authorizations

BearerAuth

AuthorizationstringRequired

Send the access token as a Bearer token in the Authorization header.

Path parameters

organization_uuidstring · uuidRequired

The organization UUID.

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

Body

application/json

resource_namestringRequired

Resource name. This value is used when generating the default CDN hostname.

Example: small-storage

resource_labelstringOptional

Optional label for the resource.

Example: labelstorage

data_sourcestringRequired

Data source for the resource. Use storage for CDN Storage-backed resources.

Example: storage

resource_typestring · enumRequired

Resource type/plan.

Example: smallPossible values:

storage_versionstringRequired

Storage API version associated with the storage path configuration.

Example: v2

storage_path_uuidstring · uuidRequired

UUID of the storage path.

Example: 8c3a1a2e-1a5a-4a4a-9d2f-3b2f9a5b9c11

storage_path_directorystringRequired

Directory name under the storage path.

Example: test

Responses

200

Resource created successfully.

application/json

post

/api/v1/cdn/{organization_uuid}/resource

HTTPcURLJavaScriptPython

POST /api/v1/cdn/{organization_uuid}/resource HTTP/1.1
Host: cloud.medianova.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 227

{
  "resource_name": "small-storage",
  "resource_label": "labelstorage",
  "data_source": "storage",
  "resource_type": "small",
  "storage_version": "v2",
  "storage_path_uuid": "8c3a1a2e-1a5a-4a4a-9d2f-3b2f9a5b9c11",
  "storage_path_directory": "test"
}

200

Resource created successfully.

{
  "status": true,
  "data": {
    "resource_uuid": "5a3a9e1c-3c71-4b43-8c5a-7a8c9f0f1b2c",
    "resource_type": "small",
    "resource_name": "small-storage.sm",
    "cdn_url": "small-storage.sm.mncdn.org",
    "resource_label": "labelstorage",
    "ssl_certificate": "shared_ssl",
    "created_at": "2024-12-27T10:41:47.000000Z",
    "storage_version": "v2",
    "storage_path_uuid": "8c3a1a2e-1a5a-4a4a-9d2f-3b2f9a5b9c11",
    "storage_path_directory": "test",
    "data_source": "storage",
    "gzip_text": false,
    "gzip_image": false,
    "brotli": false,
    "image_optimization": false,
    "webp": true,
    "avif": null,
    "http2": true,
    "status_qs": false,
    "status_secure_token": false
  }
}

Create a dynamic CDN resource

post

Create a CDN resource that pulls content from one or more origin servers. Provide origin settings (protocol, ports, host header, and priority) to configure how the CDN connects to your origin.

Authorizations

BearerAuth

AuthorizationstringRequired

Send the access token as a Bearer token in the Authorization header.

Path parameters

organization_uuidstring · uuidRequired

The organization UUID.

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

Body

application/json

resource_namestringRequired

Resource name. This value is used when generating the default CDN hostname.

resource_labelstring · nullableOptional

Optional label for the resource.

data_sourcestring · enumRequired

Data source for the resource.

Possible values:

resource_typestring · enumRequired

Resource type.

Possible values:

origin_typestring · enumRequired

Origin type.

Possible values:

server_namestringRequired

Primary domain/hostname associated with this resource (used for configuration and routing).

Example: testtest.com

Responses

200

Resource created successfully.

application/json

400

Invalid request payload.

application/json

401

Unauthorized. Missing or invalid access token.

application/json

post

/api/v1/cdn/{organization_uuid}/resource

HTTPcURLJavaScriptPython

POST /api/v1/cdn/{organization_uuid}/resource HTTP/1.1
Host: cloud.medianova.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 358

{
  "resource_name": "test",
  "resource_label": "",
  "data_source": "origin",
  "resource_type": "dynamic",
  "origin_type": "mainstream",
  "origin_settings": [
    {
      "protocol": "https",
      "origin_url": "dynamic.com",
      "host_header": "host.com",
      "http_port": 80,
      "https_port": 443,
      "is_delete": false,
      "status_origin_s3_presign": false,
      "weight": 50,
      "priority": "primary"
    }
  ],
  "server_name": "testtest.com"
}

{
  "status": true,
  "data": {
    "resource_uuid": "5a3a9e1c-3c71-4b43-8c5a-7a8c9f0f1b2c",
    "resource_name": "test.sm",
    "resource_type": "dynamic",
    "resource_platform_type": "cache",
    "cdn_url": "test.sm.mncdn.com",
    "origin_type": "mainstream",
    "origin_settings": [
      {
        "id": 1,
        "weight": 50,
        "priority": "primary",
        "protocol": "http",
        "http_port": 80,
        "https_port": 443,
        "origin_url": "ascascasc.com",
        "host_header": null
      }
    ],
    "status": "active",
    "updating_status": "up_to_date",
    "created_at": "2025-08-06T11:39:51.000000Z",
    "updated_at": "2025-08-07T10:40:46.000000Z",
    "ssl_status": true,
    "ssl_type": "shared_ssl",
    "data_source": "origin",
    "origin_response_timeout": 30,
    "tls_version": [
      "tlsv1.2",
      "tlsv1.3"
    ],
    "http2": true,
    "brotli": false,
    "gzip_text": false,
    "gzip_image": false,
    "image_optimization": false,
    "webp": false,
    "avif": false,
    "status_secure_token": false,
    "status_qs": "on"
  }
}

Create a streaming CDN resource

post

Create a streaming resource that pulls content from an origin. Provide the origin protocol and origin hostname/URL to configure the source.

Authorizations

BearerAuth

AuthorizationstringRequired

Send the access token as a Bearer token in the Authorization header.

Path parameters

organization_uuidstring · uuidRequired

The organization UUID.

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

Body

application/json

resource_namestringRequired

Resource name. This value is used when generating the default CDN hostname.

Example: streaming-test

resource_labelstring · nullableOptional

Optional label for the resource.

data_sourcestring · enumRequired

Data source for the resource.

Example: originPossible values:

resource_typestring · enumRequired

Resource type.

Example: streamingPossible values:

protocolstring · enumRequired

Protocol used to connect to the origin.

Example: httpsPossible values:

origin_urlstringRequired

Origin hostname or URL.

Example: streaming-test.com

Responses

200

Resource created successfully.

application/json

400

Invalid request payload.

application/json

401

Unauthorized. Missing or invalid access token.

application/json

post

/api/v1/cdn/{organization_uuid}/resource

HTTPcURLJavaScriptPython

POST /api/v1/cdn/{organization_uuid}/resource HTTP/1.1
Host: cloud.medianova.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 158

{
  "resource_name": "streaming-test",
  "resource_label": "",
  "data_source": "origin",
  "resource_type": "streaming",
  "protocol": "https",
  "origin_url": "streaming-test.com"
}

{
  "status": true,
  "data": {
    "resource_uuid": "5a3a9e1c-3c71-4b43-8c5a-7a8c9f0f1b2c",
    "resource_type": "streaming",
    "resource_name": "streaming-test",
    "cdn_url": "streaming-test.mncdn.com",
    "resource_label": null,
    "ssl_certificate": "shared_ssl",
    "created_at": "2025-08-06T11:42:23.000000Z",
    "data_source": "origin",
    "protocol": "https",
    "origin_url": "test.com",
    "gzip_text": false,
    "http2": true
  }
}

Create an RTMP push streaming resource

post

Create a streaming resource for RTMP push workflows. Provide RTMP authentication credentials to protect publishing access.

Authorizations

BearerAuth

AuthorizationstringRequired

Send the access token as a Bearer token in the Authorization header.

Path parameters

organization_uuidstring · uuidRequired

The organization UUID.

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

Body

application/json

resource_namestringRequired

Resource name. This value is used when generating the default CDN hostname.

Example: test-rtmp-push

resource_labelstring · nullableOptional

Optional label for the resource.

data_sourcestring · enumRequired

Data source for the resource.

Example: rtmp_pushPossible values:

resource_typestring · enumRequired

Resource type.

Example: streamingPossible values:

auth_usernamestringRequired

Username used for RTMP publishing authentication.

Example: test

auth_passwordstring · passwordRequired

Password used for RTMP publishing authentication.

Example: 8CharPass.

Responses

200

Resource created successfully.

application/json

400

Invalid request payload.

application/json

401

Unauthorized. Missing or invalid access token.

application/json

post

/api/v1/cdn/{organization_uuid}/resource

HTTPcURLJavaScriptPython

POST /api/v1/cdn/{organization_uuid}/resource HTTP/1.1
Host: cloud.medianova.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 160

{
  "resource_name": "test-rtmp-push",
  "resource_label": "",
  "data_source": "rtmp_push",
  "resource_type": "streaming",
  "auth_username": "test",
  "auth_password": "8CharPass."
}

{
  "status": true,
  "data": {
    "resource_uuid": "5a3a9e1c-3c71-4b43-8c5a-7a8c9f0f1b2c",
    "resource_type": "streaming",
    "resource_name": "test-rtmp-push",
    "cdn_url": "test-rtmp-push.mncdn.com",
    "resource_label": null,
    "ssl_certificate": "shared_ssl",
    "created_at": "2025-08-06T11:44:59.000000Z",
    "data_source": "rtmp_push",
    "auth_status": true,
    "auth_username": "test",
    "gzip_text": false,
    "http2": true
  }
}

Create an FLV streaming resource

post

Create a streaming resource for FLV delivery. Provide the origin URL and streaming protocol, and configure whether the FLV media server option is enabled.

Authorizations

BearerAuth

AuthorizationstringRequired

Send the access token as a Bearer token in the Authorization header.

Path parameters

organization_uuidstring · uuidRequired

The organization UUID.

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

Body

application/json

resource_namestringRequired

Resource name. This value is used when generating the default CDN hostname.

Example: test

resource_labelstring · nullableOptional

Optional label for the resource.

data_sourcestring · enumRequired

Data source for the resource.

Example: stream_flvPossible values:

resource_typestring · enumRequired

Resource type.

Example: streamingPossible values:

protocolstring · enumRequired

Streaming protocol used for this resource.

Example: rtmpPossible values:

stream_flv_media_serverbooleanRequired

Enable or disable the FLV media server option.

Example: false

origin_urlstringRequired

Origin hostname or URL.

Example: flv.test.com

Responses

200

Resource created successfully.

application/json

400

Invalid request payload.

application/json

401

Unauthorized. Missing or invalid access token.

application/json

post

/api/v1/cdn/{organization_uuid}/resource

HTTPcURLJavaScriptPython

POST /api/v1/cdn/{organization_uuid}/resource HTTP/1.1
Host: cloud.medianova.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 177

{
  "resource_name": "test",
  "resource_label": "",
  "data_source": "stream_flv",
  "resource_type": "streaming",
  "protocol": "rtmp",
  "stream_flv_media_server": false,
  "origin_url": "flv.test.com"
}

{
  "status": true,
  "data": {
    "resource_uuid": "5a3a9e1c-3c71-4b43-8c5a-7a8c9f0f1b2c",
    "resource_type": "streaming",
    "resource_name": "test",
    "cdn_url": "test.mncdn.com",
    "resource_label": null,
    "ssl_certificate": "shared_ssl",
    "created_at": "2025-08-06T11:48:00.000000Z",
    "data_source": "stream_flv",
    "protocol": "rtmp",
    "origin_url": "flv.test.com",
    "gzip_text": false,
    "http2": true
  }
}

Enable or disable a CDN resource

put

Enable or disable a specific CDN resource by updating its status.

Authorizations

BearerAuth

AuthorizationstringRequired

Send the access token as a Bearer token in the Authorization header.

Path parameters

organization_uuidstring · uuidRequired

The organization UUID.

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

resource_uuidstring · uuidRequired

The resource UUID.

Example: 8c3a1a2e-1a5a-4a4a-9d2f-3b2f9a5b9c11

Body

application/json

statusbooleanRequired

Set to true to enable the resource, or false to disable it.

Responses

200

Resource status updated successfully.

application/json

400

Invalid request payload.

application/json

401

Unauthorized. Missing or invalid access token.

application/json

404

Resource not found.

application/json

put

/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}

HTTPcURLJavaScriptPython

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: 16

{
  "status": false
}

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

Delete a CDN resource

delete

Permanently delete a specific CDN resource from an organization.

Authorizations

BearerAuth

AuthorizationstringRequired

Send the access token as a Bearer token in the Authorization header.

Path parameters

organization_uuidstring · uuidRequired

The organization UUID.

Example: 2f6c4f3a-2c48-4c2b-8e13-7d7c0f4e9b2a

resource_uuidstring · uuidRequired

The resource UUID.

Example: 8c3a1a2e-1a5a-4a4a-9d2f-3b2f9a5b9c11

Responses

200

Resource deleted successfully.

application/json

404

Resource not found.

application/json

delete

/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}

HTTPcURLJavaScriptPython

DELETE /api/v1/cdn/{organization_uuid}/resource/{resource_uuid} HTTP/1.1
Host: cloud.medianova.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

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