Media API
Overview
The MK.IO Media API is the project-level REST API for managing media processing and delivery workflows in MK.IO. It provides endpoints for managing assets and storage, transforms and jobs, live events and outputs, streaming publication, filtering, and content protection.
Authentication
All endpoints require a bearer token in the Authorization header:
Authorization: Bearer <your_token>
You can create and manage your tokens in your profile settings under Your personal API tokens. Follow the API tokens guide for more information.
Usage
Base URL: https://app.mk.io
Typical usage pattern:
- Create or reference core resources such as storage, assets, and transforms.
- Run VOD or live workflows, then monitor resource state until processing is ready.
- Publish playback by creating a streaming locator and retrieving playback paths.
Endpoints
Asset Filters8 endpoints
getList Account Filters/api/v1/projects/{project_name}/media/accountFiltersgetGet Account filter/api/v1/projects/{project_name}/media/accountFilters/{filter_name}putCreate or Update Account Filter/api/v1/projects/{project_name}/media/accountFilters/{filter_name}delDelete Account Filter/api/v1/projects/{project_name}/media/accountFilters/{filter_name}getList Asset Filters/api/v1/projects/{project_name}/media/assets/{asset_name}/assetFiltersgetGet Asset Filter/api/v1/projects/{project_name}/media/assets/{asset_name}/assetFilters/{filter_name}putCreate or Update Asset Filter/api/v1/projects/{project_name}/media/assets/{asset_name}/assetFilters/{filter_name}delDelete Asset Filter/api/v1/projects/{project_name}/media/assets/{asset_name}/assetFilters/{filter_name}
Assets8 endpoints
getList Assets/api/v1/projects/{project_name}/media/assetsgetGet Asset/api/v1/projects/{project_name}/media/assets/{asset_name}putCreate or Update Asset/api/v1/projects/{project_name}/media/assets/{asset_name}delDelete Asset/api/v1/projects/{project_name}/media/assets/{asset_name}postGet file access information/api/v1/projects/{project_name}/media/assets/{asset_name}/getFileAccessInfopostList Streaming Locators/api/v1/projects/{project_name}/media/assets/{asset_name}/listStreamingLocatorsgetGet resource state/api/v1/projects/{project_name}/media/assets/{asset_name}/stategetRetrieve tracks./api/v1/projects/{project_name}/media/assets/{asset_name}/storage/
Content5 endpoints
getList Content/api/v1/projects/{project_name}/media/contentgetGet Content/api/v1/projects/{project_name}/media/content/{name}putCreate Content/api/v1/projects/{project_name}/media/content/{name}patchUpdate Content/api/v1/projects/{project_name}/media/content/{name}delDelete Content/api/v1/projects/{project_name}/media/content/{name}
Content Key Policies7 endpoints
getList Content Key Policies/api/v1/projects/{project_name}/media/contentKeyPoliciesgetGet/api/v1/projects/{project_name}/media/contentKeyPolicies/{policy_name}putCreate/api/v1/projects/{project_name}/media/contentKeyPolicies/{policy_name}patchUpdate/api/v1/projects/{project_name}/media/contentKeyPolicies/{policy_name}delDelete/api/v1/projects/{project_name}/media/contentKeyPolicies/{policy_name}postGet Secrets/api/v1/projects/{project_name}/media/contentKeyPolicies/{policy_name}/getPolicyPropertiesWithSecretsgetGet resource state/api/v1/projects/{project_name}/media/contentKeyPolicies/{policy_name}/state
Destinations5 endpoints
getList Destinations/api/v1/projects/{project_name}/media/destinationsgetGet Destination/api/v1/projects/{project_name}/media/destinations/{name}putCreate Destination/api/v1/projects/{project_name}/media/destinations/{name}patchUpdate Destination/api/v1/projects/{project_name}/media/destinations/{name}delDelete Destination/api/v1/projects/{project_name}/media/destinations/{name}
Jobs8 endpoints
getList Jobs/api/v1/projects/{project_name}/media/jobsgetList Jobs/api/v1/projects/{project_name}/media/transforms/{transform_name}/jobsgetGet Job/api/v1/projects/{project_name}/media/transforms/{transform_name}/jobs/{job_name}putCreate a Job/api/v1/projects/{project_name}/media/transforms/{transform_name}/jobs/{job_name}patchUpdate a Job/api/v1/projects/{project_name}/media/transforms/{transform_name}/jobs/{job_name}delDelete a Job/api/v1/projects/{project_name}/media/transforms/{transform_name}/jobs/{job_name}postCancel a Job/api/v1/projects/{project_name}/media/transforms/{transform_name}/jobs/{job_name}/cancelJobgetGet resource state/api/v1/projects/{project_name}/media/transforms/{transform_name}/jobs/{job_name}/state
Live Events11 endpoints
getList Live Events/api/v1/projects/{project_name}/media/liveEventsgetRetrieve a live event/api/v1/projects/{project_name}/media/liveEvents/{event_name}putCreate a live event/api/v1/projects/{project_name}/media/liveEvents/{event_name}patchUpdate a Live Event/api/v1/projects/{project_name}/media/liveEvents/{event_name}delDelete a Live Event/api/v1/projects/{project_name}/media/liveEvents/{event_name}postAllocate a Live Event/api/v1/projects/{project_name}/media/liveEvents/{event_name}/allocategetGet resource state/api/v1/projects/{project_name}/media/liveEvents/{event_name}/liveOutputs/{output_name}/statepostReset a Live Event/api/v1/projects/{project_name}/media/liveEvents/{event_name}/resetpostStart a Live Event/api/v1/projects/{project_name}/media/liveEvents/{event_name}/startgetGet resource state/api/v1/projects/{project_name}/media/liveEvents/{event_name}/statepostStop a Live Event/api/v1/projects/{project_name}/media/liveEvents/{event_name}/stop
Live Outputs4 endpoints
getList Live Outputs/api/v1/projects/{project_name}/media/liveEvents/{event_name}/liveOutputsgetGet/api/v1/projects/{project_name}/media/liveEvents/{event_name}/liveOutputs/{output_name}putCreate/api/v1/projects/{project_name}/media/liveEvents/{event_name}/liveOutputs/{output_name}delDelete/api/v1/projects/{project_name}/media/liveEvents/{event_name}/liveOutputs/{output_name}
Sources5 endpoints
getList Sources/api/v1/projects/{project_name}/media/sourcesgetGet Source/api/v1/projects/{project_name}/media/sources/{name}putCreate Source/api/v1/projects/{project_name}/media/sources/{name}patchUpdate Source/api/v1/projects/{project_name}/media/sources/{name}delDelete Source/api/v1/projects/{project_name}/media/sources/{name}
Storage9 endpoints
getList Storage instances/api/v1/projects/{project_name}/media/storagegetGet Storage instance/api/v1/projects/{project_name}/media/storage/{storage_name}putCreate or Update Storage instance/api/v1/projects/{project_name}/media/storage/{storage_name}patchPatch Storage instance/api/v1/projects/{project_name}/media/storage/{storage_name}delDelete Storage instance/api/v1/projects/{project_name}/media/storage/{storage_name}getList Storage Credentials/api/v1/projects/{project_name}/media/storage/{storage_name}/credentialspostCreate Storage Credential/api/v1/projects/{project_name}/media/storage/{storage_name}/credentialsgetGet Storage Credential/api/v1/projects/{project_name}/media/storage/{storage_name}/credentials/{credential_id}delDelete Storage Credential/api/v1/projects/{project_name}/media/storage/{storage_name}/credentials/{credential_id}
Streaming Endpoints11 endpoints
getList Streaming Endpoints/api/v1/projects/{project_name}/media/streamingEndpointsgetGet Streaming Endpoint/api/v1/projects/{project_name}/media/streamingEndpoints/{endpoint_name}putCreate Streaming Endpoint/api/v1/projects/{project_name}/media/streamingEndpoints/{endpoint_name}patchUpdate Streaming Endpoint/api/v1/projects/{project_name}/media/streamingEndpoints/{endpoint_name}delDelete Streaming Endpoint/api/v1/projects/{project_name}/media/streamingEndpoints/{endpoint_name}postRestart Streaming Endpoint/api/v1/projects/{project_name}/media/streamingEndpoints/{endpoint_name}/restartpostScale Streaming Endpoint/api/v1/projects/{project_name}/media/streamingEndpoints/{endpoint_name}/scalegetList Streaming Endpoint SKUs/api/v1/projects/{project_name}/media/streamingEndpoints/{endpoint_name}/skuspostStart Streaming Endpoint/api/v1/projects/{project_name}/media/streamingEndpoints/{endpoint_name}/startgetGet resource state/api/v1/projects/{project_name}/media/streamingEndpoints/{endpoint_name}/statepostStop Streaming Endpoint/api/v1/projects/{project_name}/media/streamingEndpoints/{endpoint_name}/stop
Streaming Locators7 endpoints
getList Streaming Locators/api/v1/projects/{project_name}/media/streamingLocatorsgetGet Streaming Locator/api/v1/projects/{project_name}/media/streamingLocators/{locator_name}putCreate or update Streaming Locator/api/v1/projects/{project_name}/media/streamingLocators/{locator_name}delDelete Streaming Locator/api/v1/projects/{project_name}/media/streamingLocators/{locator_name}postList Content Keys/api/v1/projects/{project_name}/media/streamingLocators/{locator_name}/listContentKeyspostList URL paths/api/v1/projects/{project_name}/media/streamingLocators/{locator_name}/listPathsgetGet resource state/api/v1/projects/{project_name}/media/streamingLocators/{locator_name}/state
Streaming Policies4 endpoints
getList Streaming Policies/api/v1/projects/{project_name}/media/streamingPoliciesgetGet/api/v1/projects/{project_name}/media/streamingPolicies/{policy_name}putCreate or Update/api/v1/projects/{project_name}/media/streamingPolicies/{policy_name}delDelete/api/v1/projects/{project_name}/media/streamingPolicies/{policy_name}
Transforms4 endpoints
getList Transforms/api/v1/projects/{project_name}/media/transformsgetGet Transform/api/v1/projects/{project_name}/media/transforms/{transform_name}putCreate or Update Transform/api/v1/projects/{project_name}/media/transforms/{transform_name}delDelete a Transform/api/v1/projects/{project_name}/media/transforms/{transform_name}