Navigation and key features

Dashboard overview

When you log in to MK.IO, the Dashboard provides centralised access to all platform features.

Top navigation bar:

• Documentation — Access to guides and references
• API Reference — Complete API documentation
• Organisation settings — Account and billing management

Organisation management:

If you are linked to multiple subscriptions, use the organisation selector in the top-right corner to switch between accounts and manage subscriptions.

Left sidebar navigation

The sidebar organises MK.IO features into logical groups:

Organise

Create

Deliver

API access and automation

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

• 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 Organisation Settings > API 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

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 and 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 a URL, username, and password for metric scraping.

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 the 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

MK.IO uses monthly billing based on actual usage. Charges are metered and reported from the platform. You can track and manage costs at the project level.

Accessing billing information

1. Open the profile dropdown in the top-right corner.
2. Navigate to Organisation Settings > Overview.
3. Select the Billing tab for detailed usage information.

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:

• Organisation 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 Management > Teams.
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 the 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 a single viewing experience
• Support for various layouts (2×2, 1+3, custom arrangements)
• Server-side processing for optimised delivery
• Suitable 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 optimisation

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 optimisation tips

Technical support

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