# Media API

[Download OpenAPI spec](https://docs.mediakind.com/openapi/mkio/media-api.json)

Base URL `https://app.mk.io` v0.26.1381 endpoints OpenAPI 3.0.2

## 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](https://app.mk.io/user/profile) under **Your personal API tokens**. Follow the [API tokens guide](https://docs.mediakind.com/mkio/how-to/managing-your-organization/api-tokens) 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 Filters 8 endpoints
- [getList Account Filters /api/v1/projects/{project_name}/media/accountFilters](https://docs.mediakind.com/api-reference/media-api/asset-filters/list-account-filters)
- [get Get Account filter /api/v1/projects/{project_name}/media/accountFilters/{filter_name}](https://docs.mediakind.com/api-reference/media-api/asset-filters/get-account-filter)
- [put Create or Update Account Filter /api/v1/projects/{project_name}/media/accountFilters/{filter_name}](https://docs.mediakind.com/api-reference/media-api/asset-filters/create-or-update-account-filter)
- [del Delete Account Filter /api/v1/projects/{project_name}/media/accountFilters/{filter_name}](https://docs.mediakind.com/api-reference/media-api/asset-filters/delete-account-filter)
- [get List Asset Filters /api/v1/projects/{project_name}/media/assets/{asset_name}/assetFilters](https://docs.mediakind.com/api-reference/media-api/asset-filters/list-asset-filters)
- [get Get Asset Filter /api/v1/projects/{project_name}/media/assets/{asset_name}/assetFilters/{filter_name}](https://docs.mediakind.com/api-reference/media-api/asset-filters/get-asset-filter)
- [put Create or Update Asset Filter /api/v1/projects/{project_name}/media/assets/{asset_name}/assetFilters/{filter_name}](https://docs.mediakind.com/api-reference/media-api/asset-filters/create-or-update-asset-filter)
- [del Delete Asset Filter /api/v1/projects/{project_name}/media/assets/{asset_name}/assetFilters/{filter_name}](https://docs.mediakind.com/api-reference/media-api/asset-filters/delete-asset-filter)

### Assets 8 endpoints
- [get List Assets /api/v1/projects/{project_name}/media/assets](https://docs.mediakind.com/api-reference/media-api/assets/list-assets)
- [get Get Asset /api/v1/projects/{project_name}/media/assets/{asset_name}](https://docs.mediakind.com/api-reference/media-api/assets/get-asset)
- [put Create or Update Asset /api/v1/projects/{project_name}/media/assets/{asset_name}](https://docs.mediakind.com/api-reference/media-api/assets/create-or-update-asset)
- [del Delete Asset /api/v1/projects/{project_name}/media/assets/{asset_name}](https://docs.mediakind.com/api-reference/media-api/assets/delete-asset)
- [post Get file access information /api/v1/projects/{project_name}/media/assets/{asset_name}/getFileAccessInfo](https://docs.mediakind.com/api-reference/media-api/assets/get-file-access-information)
- [post List Streaming Locators /api/v1/projects/{project_name}/media/assets/{asset_name}/listStreamingLocators](https://docs.mediakind.com/api-reference/media-api/assets/list-streaming-locators)
- [get Get resource state /api/v1/projects/{project_name}/media/assets/{asset_name}/state](https://docs.mediakind.com/api-reference/media-api/assets/get-resource-state)
- [get Retrieve tracks /api/v1/projects/{project_name}/media/assets/{asset_name}/storage/](https://docs.mediakind.com/api-reference/media-api/assets/retrieve-tracks)

### Content Key Policies 7 endpoints
- [get List Content Key Policies /api/v1/projects/{project_name}/media/contentKeyPolicies](https://docs.mediakind.com/api-reference/media-api/content-key-policies/list-content-key-policies)
- [get Get /api/v1/projects/{project_name}/media/contentKeyPolicies/{policy_name}](https://docs.mediakind.com/api-reference/media-api/content-key-policies/get)
- [put Create /api/v1/projects/{project_name}/media/contentKeyPolicies/{policy_name}](https://docs.mediakind.com/api-reference/media-api/content-key-policies/create)
- [patch Update /api/v1/projects/{project_name}/media/contentKeyPolicies/{policy_name}](https://docs.mediakind.com/api-reference/media-api/content-key-policies/update)
- [del Delete /api/v1/projects/{project_name}/media/contentKeyPolicies/{policy_name}](https://docs.mediakind.com/api-reference/media-api/content-key-policies/delete)
- [post Get Secrets /api/v1/projects/{project_name}/media/contentKeyPolicies/{policy_name}/getPolicyPropertiesWithSecrets](https://docs.mediakind.com/api-reference/media-api/content-key-policies/get-secrets)
- [get Get resource state /api/v1/projects/{project_name}/media/contentKeyPolicies/{policy_name}/state](https://docs.mediakind.com/api-reference/media-api/content-key-policies/get-resource-state)

### Jobs 8 endpoints
- [get List Jobs /api/v1/projects/{project_name}/media/jobs](https://docs.mediakind.com/api-reference/media-api/jobs/list-jobs)
- [get List Jobs /api/v1/projects/{project_name}/media/transforms/{transform_name}/jobs](https://docs.mediakind.com/api-reference/media-api/jobs/list-jobs-get)
- [get Get Job /api/v1/projects/{project_name}/media/transforms/{transform_name}/jobs/{job_name}](https://docs.mediakind.com/api-reference/media-api/jobs/get-job)
- [put Create a Job /api/v1/projects/{project_name}/media/transforms/{transform_name}/jobs/{job_name}](https://docs.mediakind.com/api-reference/media-api/jobs/create-a-job)
- [patch Update a Job /api/v1/projects/{project_name}/media/transforms/{transform_name}/jobs/{job_name}](https://docs.mediakind.com/api-reference/media-api/jobs/update-a-job)
- [del Delete a Job /api/v1/projects/{project_name}/media/transforms/{transform_name}/jobs/{job_name}](https://docs.mediakind.com/api-reference/media-api/jobs/delete-a-job)
- [post Cancel a Job /api/v1/projects/{project_name}/media/transforms/{transform_name}/jobs/{job_name}/cancelJob](https://docs.mediakind.com/api-reference/media-api/jobs/cancel-a-job)
- [get Get resource state /api/v1/projects/{project_name}/media/transforms/{transform_name}/jobs/{job_name}/state](https://docs.mediakind.com/api-reference/media-api/jobs/get-resource-state)

### Live Events 11 endpoints
- [get List Live Events /api/v1/projects/{project_name}/media/liveEvents](https://docs.mediakind.com/api-reference/media-api/live-events/list-live-events)
- [get Retrieve a live event /api/v1/projects/{project_name}/media/liveEvents/{event_name}](https://docs.mediakind.com/api-reference/media-api/live-events/retrieve-a-live-event)
- [put Create a live event /api/v1/projects/{project_name}/media/liveEvents/{event_name}](https://docs.mediakind.com/api-reference/media-api/live-events/create-a-live-event)
- [patch Update a Live Event /api/v1/projects/{project_name}/media/liveEvents/{event_name}](https://docs.mediakind.com/api-reference/media-api/live-events/update-a-live-event)
- [del Delete a Live Event /api/v1/projects/{project_name}/media/liveEvents/{event_name}](https://docs.mediakind.com/api-reference/media-api/live-events/delete-a-live-event)
- [post Allocate a Live Event /api/v1/projects/{project_name}/media/liveEvents/{event_name}/allocate](https://docs.mediakind.com/api-reference/media-api/live-events/allocate-a-live-event)
- [get Get resource state /api/v1/projects/{project_name}/media/liveEvents/{event_name}/liveOutputs/{output_name}/state](https://docs.mediakind.com/api-reference/media-api/live-events/get-resource-state)
- [post Reset a Live Event /api/v1/projects/{project_name}/media/liveEvents/{event_name}/reset](https://docs.mediakind.com/api-reference/media-api/live-events/reset-a-live-event)
- [post Start a Live Event /api/v1/projects/{project_name}/media/liveEvents/{event_name}/start](https://docs.mediakind.com/api-reference/media-api/live-events/start-a-live-event)
- [get Get resource state /api/v1/projects/{project_name}/media/liveEvents/{event_name}/state](https://docs.mediakind.com/api-reference/media-api/live-events/get-resource-state-get)
- [post Stop a Live Event /api/v1/projects/{project_name}/media/liveEvents/{event_name}/stop](https://docs.mediakind.com/api-reference/media-api/live-events/stop-a-live-event)

### Live Outputs 4 endpoints
- [get List Live Outputs /api/v1/projects/{project_name}/media/liveEvents/{event_name}/liveOutputs](https://docs.mediakind.com/api-reference/media-api/live-outputs/list-live-outputs)
- [get Get /api/v1/projects/{project_name}/media/liveEvents/{event_name}/liveOutputs/{output_name}](https://docs.mediakind.com/api-reference/media-api/live-outputs/get)
- [put Create /api/v1/projects/{project_name}/media/liveEvents/{event_name}/liveOutputs/{output_name}](https://docs.mediakind.com/api-reference/media-api/live-outputs/create)
- [del Delete /api/v1/projects/{project_name}/media/liveEvents/{event_name}/liveOutputs/{output_name}](https://docs.mediakind.com/api-reference/media-api/live-outputs/delete)

### Storage 9 endpoints
- [get List Storage instances /api/v1/projects/{project_name}/media/storage](https://docs.mediakind.com/api-reference/media-api/storage/list-storage-instances)
- [get Get Storage instance /api/v1/projects/{project_name}/media/storage/{storage_name}](https://docs.mediakind.com/api-reference/media-api/storage/get-storage-instance)
- [put Create or Update Storage instance /api/v1/projects/{project_name}/media/storage/{storage_name}](https://docs.mediakind.com/api-reference/media-api/storage/create-or-update-storage-instance)
- [patch Patch Storage instance /api/v1/projects/{project_name}/media/storage/{storage_name}](https://docs.mediakind.com/api-reference/media-api/storage/patch-storage-instance)
- [del Delete Storage instance /api/v1/projects/{project_name}/media/storage/{storage_name}](https://docs.mediakind.com/api-reference/media-api/storage/delete-storage-instance)
- [get List Storage Credentials /api/v1/projects/{project_name}/media/storage/{storage_name}/credentials](https://docs.mediakind.com/api-reference/media-api/storage/list-storage-credentials)
- [post Create Storage Credential /api/v1/projects/{project_name}/media/storage/{storage_name}/credentials](https://docs.mediakind.com/api-reference/media-api/storage/create-storage-credential)
- [get Get Storage Credential /api/v1/projects/{project_name}/media/storage/{storage_name}/credentials/{credential_id}](https://docs.mediakind.com/api-reference/media-api/storage/get-storage-credential)
- [del Delete Storage Credential /api/v1/projects/{project_name}/media/storage/{storage_name}/credentials/{credential_id}](https://docs.mediakind.com/api-reference/media-api/storage/delete-storage-credential)

### Streaming Endpoints 11 endpoints
- [get List Streaming Endpoints /api/v1/projects/{project_name}/media/streamingEndpoints](https://docs.mediakind.com/api-reference/media-api/streaming-endpoints/list-streaming-endpoints)
- [get Get Streaming Endpoint /api/v1/projects/{project_name}/media/streamingEndpoints/{endpoint_name}](https://docs.mediakind.com/api-reference/media-api/streaming-endpoints/get-streaming-endpoint)
- [put Create Streaming Endpoint /api/v1/projects/{project_name}/media/streamingEndpoints/{endpoint_name}](https://docs.mediakind.com/api-reference/media-api/streaming-endpoints/create-streaming-endpoint)
- [patch Update Streaming Endpoint /api/v1/projects/{project_name}/media/streamingEndpoints/{endpoint_name}](https://docs.mediakind.com/api-reference/media-api/streaming-endpoints/update-streaming-endpoint)
- [del Delete Streaming Endpoint /api/v1/projects/{project_name}/media/streamingEndpoints/{endpoint_name}](https://docs.mediakind.com/api-reference/media-api/streaming-endpoints/delete-streaming-endpoint)
- [post Restart Streaming Endpoint /api/v1/projects/{project_name}/media/streamingEndpoints/{endpoint_name}/restart](https://docs.mediakind.com/api-reference/media-api/streaming-endpoints/restart-streaming-endpoint)
- [post Scale Streaming Endpoint /api/v1/projects/{project_name}/media/streamingEndpoints/{endpoint_name}/scale](https://docs.mediakind.com/api-reference/media-api/streaming-endpoints/scale-streaming-endpoint)
- [get List Streaming Endpoint SKUs /api/v1/projects/{project_name}/media/streamingEndpoints/{endpoint_name}/skus](https://docs.mediakind.com/api-reference/media-api/streaming-endpoints/list-streaming-endpoint-skus)
- [post Start Streaming Endpoint /api/v1/projects/{project_name}/media/streamingEndpoints/{endpoint_name}/start](https://docs.mediakind.com/api-reference/media-api/streaming-endpoints/start-streaming-endpoint)
- [get Get resource state /api/v1/projects/{project_name}/media/streamingEndpoints/{endpoint_name}/state](https://docs.mediakind.com/api-reference/media-api/streaming-endpoints/get-resource-state)
- [post Stop Streaming Endpoint /api/v1/projects/{project_name}/media/streamingEndpoints/{endpoint_name}/stop](https://docs.mediakind.com/api-reference/media-api/streaming-endpoints/stop-streaming-endpoint)

### Streaming Locators 7 endpoints
- [get List Streaming Locators /api/v1/projects/{project_name}/media/streamingLocators](https://docs.mediakind.com/api-reference/media-api/streaming-locators/list-streaming-locators)
- [get Get Streaming Locator /api/v1/projects/{project_name}/media/streamingLocators/{locator_name}](https://docs.mediakind.com/api-reference/media-api/streaming-locators/get-streaming-locator)
- [put Create or update Streaming Locator /api/v1/projects/{project_name}/media/streamingLocators/{locator_name}](https://docs.mediakind.com/api-reference/media-api/streaming-locators/create-or-update-streaming-locator)
- [del Delete Streaming Locator /api/v1/projects/{project_name}/media/streamingLocators/{locator_name}](https://docs.mediakind.com/api-reference/media-api/streaming-locators/delete-streaming-locator)
- [post List Content Keys /api/v1/projects/{project_name}/media/streamingLocators/{locator_name}/listContentKeys](https://docs.mediakind.com/api-reference/media-api/streaming-locators/list-content-keys)
- [post List URL paths /api/v1/projects/{project_name}/media/streamingLocators/{locator_name}/listPaths](https://docs.mediakind.com/api-reference/media-api/streaming-locators/list-url-paths)
- [get Get resource state /api/v1/projects/{project_name}/media/streamingLocators/{locator_name}/state](https://docs.mediakind.com/api-reference/media-api/streaming-locators/get-resource-state)

### Streaming Policies 4 endpoints
- [get List Streaming Policies /api/v1/projects/{project_name}/media/streamingPolicies](https://docs.mediakind.com/api-reference/media-api/streaming-policies/list-streaming-policies)
- [get Get /api/v1/projects/{project_name}/media/streamingPolicies/{policy_name}](https://docs.mediakind.com/api-reference/media-api/streaming-policies/get)
- [put Create or Update /api/v1/projects/{project_name}/media/streamingPolicies/{policy_name}](https://docs.mediakind.com/api-reference/media-api/streaming-policies/create-or-update)
- [del Delete /api/v1/projects/{project_name}/media/streamingPolicies/{policy_name}](https://docs.mediakind.com/api-reference/media-api/streaming-policies/delete)

### Transforms 4 endpoints
- [get List Transforms /api/v1/projects/{project_name}/media/transforms](https://docs.mediakind.com/api-reference/media-api/transforms/list-transforms)
- [get Get Transform /api/v1/projects/{project_name}/media/transforms/{transform_name}](https://docs.mediakind.com/api-reference/media-api/transforms/get-transform)
- [put Create or Update Transform /api/v1/projects/{project_name}/media/transforms/{transform_name}](https://docs.mediakind.com/api-reference/media-api/transforms/create-or-update-transform)
- [del Delete a Transform /api/v1/projects/{project_name}/media/transforms/{transform_name}](https://docs.mediakind.com/api-reference/media-api/transforms/delete-a-transform)