Create or Update

PUT

https://app.mk.io/api/v1/projects/:project_name/media/streamingPolicies/:policy_name

PUT

/api/v1/projects/:project_name/media/streamingPolicies/:policy_name

curl -X PUT https://app.mk.io/api/v1/projects/project_name/media/streamingPolicies/policy_name \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "properties": {}
}'

{
  "properties": {
    "catalog": {},
    "commonEncryptionCbcs": {
      "clearKeyEncryptionConfiguration": {
        "customKeysAcquisitionUrlTemplate": "string"
      },
      "clearTracks": [
        {
          "trackSelections": [
            {
              "operation": "Unknown",
              "property": "Unknown",
              "value": "string"
            }
          ]
        }
      ],
      "contentKeys": {
        "defaultKey": {
          "label": "string",
          "policyName": "string"
        },
        "keyToTrackMappings": [
          {
            "label": "string",
            "policyName": "string",
            "tracks": [
              {
                "trackSelections": [
                  {
                    "operation": "Unknown",
                    "property": "Unknown",
                    "value": "string"
                  }
                ]
              }
            ]
          }
        ]
      },
      "drm": {
        "fairPlay": {
          "allowPersistentLicense": true,
          "customLicenseAcquisitionUrlTemplate": "string"
        },
        "playReady": {
          "customLicenseAcquisitionUrlTemplate": "string",
          "playReadyCustomAttributes": "string"
        },
        "widevine": {
          "customLicenseAcquisitionUrlTemplate": "string"
        }
      },
      "enabledProtocols": {
        "dash": true,
        "download": true,
        "hls": true,
        "smoothStreaming": true
      }
    },
    "commonEncryptionCenc": {
      "clearKeyEncryptionConfiguration": {
        "customKeysAcquisitionUrlTemplate": "string"
      },
      "clearTracks": [
        {
          "trackSelections": [
            {
              "operation": "Unknown",
              "property": "Unknown",
              "value": "string"
            }
          ]
        }
      ],
      "contentKeys": {
        "defaultKey": {
          "label": "string",
          "policyName": "string"
        },
        "keyToTrackMappings": [
          {
            "label": "string",
            "policyName": "string",
            "tracks": [
              {
                "trackSelections": [
                  {
                    "operation": "Unknown",
                    "property": "Unknown",
                    "value": "string"
                  }
                ]
              }
            ]
          }
        ]
      },
      "drm": {
        "playReady": {
          "customLicenseAcquisitionUrlTemplate": "string",
          "playReadyCustomAttributes": "string"
        },
        "widevine": {
          "customLicenseAcquisitionUrlTemplate": "string"
        }
      },
      "enabledProtocols": {
        "dash": true,
        "download": true,
        "hls": true,
        "smoothStreaming": true
      }
    },
    "defaultContentKeyPolicyName": "string",
    "envelopeEncryption": {
      "clearTracks": [
        {
          "trackSelections": [
            {
              "operation": "Unknown",
              "property": "Unknown",
              "value": "string"
            }
          ]
        }
      ],
      "contentKeys": {
        "defaultKey": {
          "label": "string",
          "policyName": "string"
        },
        "keyToTrackMappings": [
          {
            "label": "string",
            "policyName": "string",
            "tracks": [
              {
                "trackSelections": [
                  {
                    "operation": "Unknown",
                    "property": "Unknown",
                    "value": "string"
                  }
                ]
              }
            ]
          }
        ]
      },
      "customKeyAcquisitionUrlTemplate": "string",
      "enabledProtocols": {
        "dash": true,
        "download": true,
        "hls": true,
        "smoothStreaming": true
      }
    },
    "noEncryption": {
      "enabledProtocols": {
        "dash": true,
        "download": true,
        "hls": true,
        "smoothStreaming": true
      }
    }
  },
  "id": "string",
  "name": "name",
  "systemData": {
    "createdAt": "2024-01-15T09:30:00Z",
    "createdBy": "string",
    "createdByType": "User",
    "internalId": "string",
    "lastModifiedAt": "2024-01-15T09:30:00Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "User"
  },
  "type": "string"
}

Create or update a Streaming Policy. Updating an existing policy may not be available on all accounts.

RBAC Capability Required: ams.streamingpolicy.create or ams.streamingpolicy.update

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

project_namestringRequired

policy_namestringRequired

Request

This endpoint expects an object.

propertiesobjectRequired

The properties of the streaming policy.

Response

Streaming Policy updated

propertiesobject

The properties of the streaming policy.

idstringOptionalRead-only

Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

namestringOptionalRead-onlyformat: "^[^\^\'<>%&:\\?/*+]+$"1-260 characters

The name of the resource

systemDataobjectOptional

Metadata pertaining to creation and last modification of the resource.

typestringOptionalRead-only

The type of the resource. E.g. "Microsoft.Media/mediaservices/assets"

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error