Which API to use
Choose an MK.IO API based on the resource you need to manage, not the kind of code you are writing. The APIs share a base URL and bearer authentication, but they own different parts of the platform and are often combined in a single automation flow.
Start with the workflow
Section titled “Start with the workflow”Use this table for a quick answer:
| To automate… | Use the… |
|---|---|
| Storage registration, assets, transforms, jobs, live events, streaming locators, streaming endpoints, streaming policies, or content key policies | Media API |
| Organizations, projects, users, teams, tokens, payment methods, usage reports, metrics, or webhook rules | Management API |
| Beam device registration, backups, restores, software rollouts, or support packages | Fleets API |
| Networks and sites for Beam deployments | Infrastructure API |
| Flows endpoint and schema details | Flows API |
How the APIs fit together
Section titled “How the APIs fit together”The APIs are separate, but the workflows connect:
- Use the Management API to create a project and assign billing.
- Use the Media API to process or publish content inside that project.
- Use the Management API again to add webhook rules, so your integration reacts to events instead of polling.
- Use the Infrastructure API to define sites and networks for a Beam deployment.
- Use the Fleets API to onboard and operate the Beam devices in those sites.
A complete platform integration typically uses the Management API for setup, then the Media, Fleets, or Infrastructure API for day-to-day operations.
Media API
Section titled “Media API”The Media API owns media processing and delivery, and it is where most developers start. Reach for it to ingest, encode, package, protect, or stream content. Its resources include storage instances and credentials, assets and asset filters, transforms and jobs, live events and live outputs, streaming locators and endpoints, and streaming policies and content key policies.
Management API
Section titled “Management API”The Management API owns organization and project administration: access, billing, and account-level configuration. Reach for it to provision an environment, assign permissions, issue tokens, or configure event delivery. Its resources include organizations and projects, users and invites, teams, roles and scopes, personal and organization tokens, payment methods, usage and metrics, and webhook rules.
Fleets API
Section titled “Fleets API”The Fleets API is the project-scoped operational API for MK.IO Beam, the on-premises product. Reach for it to register devices, protect device state with backups, restore configurations, manage software versions, and collect support packages. Its resources include device inventory and registration, backups and restores, software selection and preload behaviour, and support packages and diagnostics.
Infrastructure API
Section titled “Infrastructure API”The Infrastructure API defines where Beam devices live and which networks are available to them, so it is usually used before or alongside the Fleets API. Its resources include networks, sites, routes from sites to networks, and label-driven filtering of network and site resources.
Common combinations
Section titled “Common combinations”| Workflow | APIs involved |
|---|---|
| Create a project, assign billing, then start a VOD workflow | Management API, then Media API |
| Register a webhook for job-completion events | Management API and Media API |
| Define sites and networks, then register Beam devices to them | Infrastructure API, then Fleets API |
| Audit token usage and restrict automation access | Management API |
Next step
Section titled “Next step”Once you know which API owns your workflow, make one authenticated request before you build anything larger. Your first API call is the quickest way to confirm that your base URL, token, and project access are correct.