Navigation & key features

Dashboard overview

When you log into MK.IO, the Dashboard provides centralized access to all platform features:

Top navigation bar:

  • Documentation - Access to guides and references
  • API Reference - Complete API documentation
  • Organization settings - Account and billing management

Organization management: If linked to multiple subscriptions, use the organization selector (top-right corner) to switch between different accounts and manage subscriptions.


Left sidebar navigation

The sidebar organizes MK.IO features into logical groups:

Organize

Manage assets

Manage, import, and upload new media content from storage.

Configure storage

Add and connect cloud storage for content management.

Create

Live events

Configure and manage live streaming workflows.

Video processing

Set up VOD transformations and encoding jobs.

Deliver

Content key policies

Enable DRM protection for secure content delivery.

Streaming endpoints

Create and manage delivery points for your streams.

MK player

Test your streams and explore player SDK documentation.


API access and automation

API token management:

MK.IO provides comprehensive APIs to automate any action available in the web interface

  • Storage account creation
  • Asset import and management
  • Live event creation and control
  • Transformation job execution
  • Endpoint and locator management

Getting API access:

  1. Generate API tokens from Organization SettingsAPI Tokens (See API tokens)
  2. Use Bearer Token authentication with your API calls
  3. All API endpoints use the base URL: https://api.mk.io

API usage example:

curl --request PUT \
     --url https://api.mk.io/api/v1/projects/example-project/media/transforms/example-transform/jobs/example-job \
     --header 'accept: application/json' \
     --header 'authorization: Bearer <your-token>' \
     --header 'content-type: application/json' \
     --data '
{
  "properties": {
    "input": {
      "@odata.type": "#Microsoft.Media.JobInputAsset",
      "assetName": "example-asset"
    },
    "priority": "Normal",
    "outputs": [
      {
        "@odata.type": "#Microsoft.Media.JobOutputAsset",
        "assetName": "example-output-asset"
      }
    ]
  }
}
'

Monitoring and metrics

Metrics overview:

MK.IO provides operational metrics for monitoring your services:

Available metrics include:

  • Live events - Input/output bitrate monitoring
  • Streaming endpoints - Error rates, bitrate, and latency
  • Encoding jobs - Success/failure counts for completed jobs

Enabling metrics:

  1. Go to Usage and Metrics from the left menu
  2. Enable metrics using the toggle switch
  3. MK.IO provides URL, username, and password for metric scraping

Note: Metrics publishing is a chargeable service not enabled by default. See MK.IO pricing for details.

Grafana cloud integration:

For comprehensive monitoring, you can integrate with Grafana Cloud:

  1. Create a free Grafana Cloud account (supports up to 10,000 metric series)
  2. Set up Metrics Endpoint integration
  3. Configure scraping from MK.IO's federate endpoint
  4. Import pre-built dashboards or explore metrics (all begin with mk_)

Common metric types:

  • Gauge metrics - Current values (endpoint status, bitrates)
  • Counter metrics - Cumulative counts (completed jobs, errors)
  • Histogram metrics - Response time distributions

Billing and cost management

Billing overview:

  • Monthly billing based on actual usage
  • Charges metered and reported from the platform
  • Project-level cost tracking and management

Accessing billing information:

  1. Open profile dropdown (top-right corner)
  2. Navigate to Organization SettingsOverview
  3. Select Billing tab for detailed usage information

Access requirement: Billing information is only available to members of the Administrators team.

Cost considerations:

  • Streaming Endpoints - Generate costs when running, even if idle
  • Transformation Jobs - Charged based on processing time and complexity
  • Bandwidth - Charges apply when content is accessed by viewers
  • Storage - Based on your cloud provider's storage costs
  • Metrics - Optional chargeable service for monitoring

Access management and security

Team management:

MK.IO provides granular access control through team-based permissions:

User roles and capabilities:

  • Organization Owner - Full control over all settings and billing
  • Administrators - Management access and billing visibility
  • Content Managers - Asset and workflow management
  • Viewers - Read-only access to content and analytics

Setting up teams:

  1. Go to Access ManagementTeams
  2. Create user groups based on responsibilities
  3. Assign specific permissions to each group
  4. Invite colleagues with appropriate access levels

Security best practices:

  • Regularly review and rotate API tokens
  • Use principle of least privilege for team access
  • Monitor access logs for unusual activity
  • Implement strong authentication policies

Integration capabilities

Cloud storage integration:

  • Azure Storage - Blob storage with SAS token authentication
  • Amazon S3 - Standard S3 buckets with IAM credentials
  • Google Cloud Storage - Coming soon

Player integration:

  • MKPlayer SDK - Advanced web player included with MK.IO
  • Third-party players - Support for standard HLS and DASH protocols
  • Custom applications - Full API access for building integrated solutions

Workflow integration:

  • REST APIs - Complete programmatic access to all features
  • Webhooks - Event notifications for workflow automation
  • SDKs - Client libraries for popular programming languages

Advanced features preview

Multiview (coming soon):

  • Combine multiple live streams into single viewing experience
  • Support for various layouts (2x2, 1+3, custom arrangements)
  • Server-side processing for optimized delivery
  • Perfect for sports, news, and entertainment applications

AI capabilities:

  • Live transcription - Real-time subtitle generation
  • Translation - Multi-language content delivery
  • Content analysis - Automated content understanding
  • Quality enhancement - AI-powered video optimization

Getting help and support

Documentation resources:

  • Getting Started Guides - Step-by-step tutorials (this guide)
  • API Reference - Complete endpoint documentation
  • Player SDK Documentation - Integration guides for MKPlayer

Community support:

  • MK.IO Community - User forums and discussions
  • Knowledge Base - Common questions and solutions
  • Best Practices - Industry insights and optimization tips

Technical support:

  • Support Portal - Direct access to technical assistance
  • Documentation Feedback - Help improve guides and references
  • Feature Requests - Suggest new capabilities and improvements

👍

This completes your comprehensive guide to getting started with MK.IO! You now have the knowledge to create accounts, manage video workflows, and deliver content to global audiences through MK.IO.