Management API

Download OpenAPI spec
Base URLhttps://app.mk.iov0.20.1563 endpointsOpenAPI 3.0.2

Overview

The MK.IO Management API is the REST API for organization, project, and account administration in MK.IO. It supports governance and operational setup use cases, including managing users/teams/roles/scopes, project and location management, payment methods, webhook rules, usage reporting, and profile/token operations.

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:

  • Identify the organization and project context.
  • Manage users, roles, teams, and project settings.
  • Create, rotate, and revoke tokens before calling Media, Infrastructure, or Fleet APIs.

Endpoints

Auth2 endpoints
getGet public keys/.well-known/jwks.jsongetGet revoked token IDs/.well-known/revoked.json
Customer Managed Clusters3 endpoints
getList customer-managed clusters/api/v1/organization/customerManagedClustersgetGet a customer-managed cluster/api/v1/organization/customerManagedClusters/{cluster_name}putRegister a customer-managed cluster/api/v1/organization/customerManagedClusters/{cluster_name}
Locations2 endpoints
getList available Locations/api/v1/locationsgetGet Location/api/v1/locations/{location_name}
Organization3 endpoints
getGet an organization/api/v1/organizationpostCreate an organization/api/v1/organizationpatchUpdate organization/api/v1/organization
Payment5 endpoints
getList Payment Methods/api/v1/organization/paymentMethodsgetGet one Payment Method/api/v1/organization/paymentMethods/{paymentmethod_id}patchPatch Payment Method/api/v1/organization/paymentMethods/{paymentmethod_id}postAccept Terms & Conditions/api/v1/organization/paymentMethods/{paymentmethod_id}/acceptTermsAndConditionsgetGet ratecard for payment method/api/v1/organization/paymentMethods/{paymentmethod_id}/rateCard
Projects8 endpoints
getList projects/api/v1/projectsgetGet a project/api/v1/projects/{project_name}putCreate a project/api/v1/projects/{project_name}patchEdit a project/api/v1/projects/{project_name}getGet metrics endpoint settings/api/v1/projects/{project_name}/metricsEndpointpatchUpdate metrics endpoint settings/api/v1/projects/{project_name}/metricsEndpointgetGet assigned payment method/api/v1/projects/{project_name}/paymentMethodpostAssign payment method/api/v1/projects/{project_name}/paymentMethod
Readiness Check1 endpoint
getEndpoint for readiness-check/api/ready
Reports2 endpoints
postGet usage report/api/v1/organization/reports/usagegetGet project usage data/api/v1/projects/{project_name}/usage
Roles2 endpoints
getList Roles/api/v1/organization/rolesgetGet a Role/api/v1/organization/roles/{role_name}
Scopes2 endpoints
getList Scopes/api/v1/organization/scopesgetGet a Scope/api/v1/organization/scopes/{scope_name}
Teams5 endpoints
getList Teams/api/v1/organization/teamsgetGet a Team/api/v1/organization/teams/{team_name}putCreate or Edit a Team/api/v1/organization/teams/{team_name}patchPatch a Team/api/v1/organization/teams/{team_name}delDelete a Team/api/v1/organization/teams/{team_name}
User Management9 endpoints
getList pending invites/api/v1/organization/invitespostCreate an invite/api/v1/organization/invitesgetGet one pending invite/api/v1/organization/invites/{invite_id}delCancel pending invite/api/v1/organization/invites/{invite_id}getGet tokens of all users/api/v1/organization/tokensdelRevoke a token of a user/api/v1/organization/tokens/{token_id}getList users/api/v1/organization/usersgetGet user details/api/v1/organization/users/{user_id}delRemove user/api/v1/organization/users/{user_id}
Webhook Rules5 endpoints
getList Webhook Rules/api/v1/projects/{project_name}/webhook/rulesgetGet Webhook Rule/api/v1/projects/{project_name}/webhook/rules/{rule_name}putCreate or Update Webhook Rule/api/v1/projects/{project_name}/webhook/rules/{rule_name}delDelete Webhook Rule/api/v1/projects/{project_name}/webhook/rules/{rule_name}getGet Webhook Events/api/v1/projects/{project_name}/webhook/rules/{rule_name}/events
Your Profile14 endpoints
getGet profileDeprecated/api/profile/putUpdate profileDeprecated/api/profile/getList user's organizations and any associated invitation/api/v1/user/organizationsgetGet organization details/api/v1/user/organizations/{organization_id}patchUpdate organization details (to accept an invitation)./api/v1/user/organizations/{organization_id}delLeave an organization/Decline an invite to an organization/api/v1/user/organizations/{organization_id}getGet profile/api/v1/user/profilepatchUpdate profile/api/v1/user/profilegetGet RBAC capability data/api/v1/user/rbacgetGet all user tokens/api/v1/user/tokenspostRequest a new token/api/v1/user/tokensdelRevoke all user tokens/api/v1/user/tokensgetGet a user token by ID/api/v1/user/tokens/{token_id}delRevoke a token/api/v1/user/tokens/{token_id}