Create a live event

puthttps://app.mk.io/api/v1/projects/:project_name/media/liveEvents/:event_name

Create a live event

RBAC Capability Required: ams.liveevent.create

Authentication

AuthorizationBearer

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

Path parameters

project_namestringRequired

event_namestringRequired

Request

This endpoint expects an object.

Loading schema details…

Response

200A live event has been created

Loading schema details…

Errors

400Bad Request

Loading schema details…

401Unauthorized

Loading schema details…

403Forbidden

Loading schema details…

404Not Found

Loading schema details…

409Conflict

Loading schema details…

429Too Many Requests

Loading schema details…

500Internal Server Error

Loading schema details…

put/api/v1/projects/{project_name}/media/liveEvents/{event_name}

curl -X PUT "https://app.mk.io/api/v1/projects/{project_name}/media/liveEvents/{event_name}" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
  "location": "string",
  "properties": {
    "crossSiteAccessPolicies": {
      "clientAccessPolicy": "string",
      "crossDomainPolicy": "string"
    },
    "description": "string",
    "encoding": {
      "encodingType": "None",
      "keyFrameInterval": "PT2S",
      "presetName": "string",
      "stretchMode": "None"
    },
    "hostnamePrefix": "string",
    "input": {
      "accessControl": {
        "ip": {
          "allow": [
            {
              "address": "string",
              "name": "string",
              "subnetPrefixLength": 0
            }
          ]
        }
      },
      "accessToken": "string",
      "endpoints": [
        {
          "protocol": "string",
          "url": "string"
        }
      ],
      "keyFrameIntervalDuration": "string",
      "streamingProtocol": "RTMP",
      "timedMetadataEndpoints": [
        {
          "url": "string"
        }
      ]
    },
    "pipeline": {
      "arguments": {
        "operation1": [
          {
            "name": "language",
            "value": "en-US"
          }
        ],
        "operation2": [
          {
            "name": "length",
            "value": "3.7m"
          }
        ]
      },
      "name": "string"
    },
    "preview": {
      "accessControl": {
        "ip": {
          "allow": [
            {
              "address": "string",
              "name": "string",
              "subnetPrefixLength": 0
            }
          ]
        }
      },
      "alternativeMediaId": "string",
      "endpoints": [
        {
          "protocol": "string",
          "url": "string"
        }
      ],
      "previewLocator": "00000000-0000-0000-0000-000000000000",
      "streamingPolicyName": "Predefined_ClearStreamingOnly"
    },
    "streamOptions": [
      "string"
    ],
    "transcriptions": [
      null
    ],
    "useStaticHostname": true
  },
  "tags": {
    "key": "string"
  }
}'

200A live event has been created

{
  "location": "string",
  "name": "name",
  "properties": {
    "created": "string",
    "crossSiteAccessPolicies": {
      "clientAccessPolicy": "string",
      "crossDomainPolicy": "string"
    },
    "description": "string",
    "encoding": {
      "encodingType": "None",
      "keyFrameInterval": "PT2S",
      "presetName": "string",
      "stretchMode": "None"
    },
    "hostnamePrefix": "string",
    "input": {
      "accessControl": {
        "ip": {
          "allow": [
            {
              "address": "string",
              "name": "string",
              "subnetPrefixLength": 0
            }
          ]
        }
      },
      "accessToken": "string",
      "endpoints": [
        {
          "protocol": "string",
          "url": "string"
        }
      ],
      "keyFrameIntervalDuration": "string",
      "streamingProtocol": "RTMP",
      "timedMetadataEndpoints": [
        {
          "url": "string"
        }
      ]
    },
    "lastModified": "string",
    "pipeline": {
      "arguments": {
        "operation1": [
          {
            "name": "language",
            "value": "en-US"
          }
        ],
        "operation2": [
          {
            "name": "length",
            "value": "3.7m"
          }
        ]
      },
      "name": "string"
    },
    "preview": {
      "accessControl": {
        "ip": {
          "allow": [
            {
              "address": "string",
              "name": "string",
              "subnetPrefixLength": 0
            }
          ]
        }
      },
      "alternativeMediaId": "string",
      "endpoints": [
        {
          "protocol": "string",
          "url": "string"
        }
      ],
      "previewLocator": "00000000-0000-0000-0000-000000000000",
      "streamingPolicyName": "Predefined_ClearStreamingOnly"
    },
    "provisioningState": "string",
    "resourceState": "Stopped",
    "streamOptions": [
      "string"
    ],
    "transcriptions": [
      null
    ],
    "useStaticHostname": true
  },
  "tags": {
    "key": "string"
  }
}