# Management API [Download OpenAPI spec](https://docs.mediakind.com/openapi/mkio/management-api.json) Base URL `https://app.mk.io` v0.19.2460 endpoints OpenAPI 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 ` 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: - 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 ### Auth 2 endpoints - [getGet public keys/.well-known/jwks.json](https://docs.mediakind.com/api-reference/management-api/auth/get-public-keys) - [getGet revoked token IDs/.well-known/revoked.json](https://docs.mediakind.com/api-reference/management-api/auth/get-revoked-token-ids) ### Locations 2 endpoints - [getList available Locations/api/v1/locations](https://docs.mediakind.com/api-reference/management-api/locations/list-available-locations) - [getGet Location/api/v1/locations/{location_name}](https://docs.mediakind.com/api-reference/management-api/locations/get-location) ### Organization 3 endpoints - [getGet an organization/api/v1/organization](https://docs.mediakind.com/api-reference/management-api/organization/get-an-organization) - [postCreate an organization/api/v1/organization](https://docs.mediakind.com/api-reference/management-api/organization/create-an-organization) - [patchUpdate organization/api/v1/organization](https://docs.mediakind.com/api-reference/management-api/organization/update-organization) ### Payment 5 endpoints - [getList Payment Methods/api/v1/organization/paymentMethods](https://docs.mediakind.com/api-reference/management-api/payment/list-payment-methods) - [getGet one Payment Method/api/v1/organization/paymentMethods/{paymentmethod_id}](https://docs.mediakind.com/api-reference/management-api/payment/get-one-payment-method) - [patchPatch Payment Method/api/v1/organization/paymentMethods/{paymentmethod_id}](https://docs.mediakind.com/api-reference/management-api/payment/patch-payment-method) - [postAccept Terms & Conditions/api/v1/organization/paymentMethods/{paymentmethod_id}/acceptTermsAndConditions](https://docs.mediakind.com/api-reference/management-api/payment/accept-terms-conditions) - [getGet ratecard for payment method/api/v1/organization/paymentMethods/{paymentmethod_id}/rateCard](https://docs.mediakind.com/api-reference/management-api/payment/get-ratecard-for-payment-method) ### Projects 8 endpoints - [getList projects/api/v1/projects](https://docs.mediakind.com/api-reference/management-api/projects/list-projects) - [getGet a project/api/v1/projects/{project_name}](https://docs.mediakind.com/api-reference/management-api/projects/get-a-project) - [putCreate a project/api/v1/projects/{project_name}](https://docs.mediakind.com/api-reference/management-api/projects/create-a-project) - [patchEdit a project/api/v1/projects/{project_name}](https://docs.mediakind.com/api-reference/management-api/projects/edit-a-project) - [getGet metrics endpoint settings/api/v1/projects/{project_name}/metricsEndpoint](https://docs.mediakind.com/api-reference/management-api/projects/get-metrics-endpoint-settings) - [patchUpdate metrics endpoint settings/api/v1/projects/{project_name}/metricsEndpoint](https://docs.mediakind.com/api-reference/management-api/projects/update-metrics-endpoint-settings) - [getGet assigned payment method/api/v1/projects/{project_name}/paymentMethod](https://docs.mediakind.com/api-reference/management-api/projects/get-assigned-payment-method) - [postAssign payment method/api/v1/projects/{project_name}/paymentMethod](https://docs.mediakind.com/api-reference/management-api/projects/assign-payment-method) ### Readiness Check 1 endpoint - [getEndpoint for readiness-check/api/ready](https://docs.mediakind.com/api-reference/management-api/readiness-check/endpoint-for-readiness-check) ### Reports 2 endpoints - [postGet usage report/api/v1/organization/reports/usage](https://docs.mediakind.com/api-reference/management-api/reports/get-usage-report) - [getGet project usage data/api/v1/projects/{project_name}/usage](https://docs.mediakind.com/api-reference/management-api/reports/get-project-usage-data) ### Roles 2 endpoints - [getList Roles/api/v1/organization/roles](https://docs.mediakind.com/api-reference/management-api/roles/list-roles) - [getGet a Role/api/v1/organization/roles/{role_name}](https://docs.mediakind.com/api-reference/management-api/roles/get-a-role) ### Scopes 2 endpoints - [getList Scopes/api/v1/organization/scopes](https://docs.mediakind.com/api-reference/management-api/scopes/list-scopes) - [getGet a Scope/api/v1/organization/scopes/{scope_name}](https://docs.mediakind.com/api-reference/management-api/scopes/get-a-scope) ### Teams 5 endpoints - [getList Teams/api/v1/organization/teams](https://docs.mediakind.com/api-reference/management-api/teams/list-teams) - [getGet a Team/api/v1/organization/teams/{team_name}](https://docs.mediakind.com/api-reference/management-api/teams/get-a-team) - [putCreate or Edit a Team/api/v1/organization/teams/{team_name}](https://docs.mediakind.com/api-reference/management-api/teams/create-or-edit-a-team) - [patchPatch a Team/api/v1/organization/teams/{team_name}](https://docs.mediakind.com/api-reference/management-api/teams/patch-a-team) - [delDelete a Team/api/v1/organization/teams/{team_name}](https://docs.mediakind.com/api-reference/management-api/teams/delete-a-team) ### User Management 9 endpoints - [getList pending invites/api/v1/organization/invites](https://docs.mediakind.com/api-reference/management-api/user-management/list-pending-invites) - [postCreate an invite/api/v1/organization/invites](https://docs.mediakind.com/api-reference/management-api/user-management/create-an-invite) - [getGet one pending invite/api/v1/organization/invites/{invite_id}](https://docs.mediakind.com/api-reference/management-api/user-management/get-one-pending-invite) - [delCancel pending invite/api/v1/organization/invites/{invite_id}](https://docs.mediakind.com/api-reference/management-api/user-management/cancel-pending-invite) - [getGet tokens of all users/api/v1/organization/tokens](https://docs.mediakind.com/api-reference/management-api/user-management/get-tokens-of-all-users) - [delRevoke a token of a user/api/v1/organization/tokens/{token_id}](https://docs.mediakind.com/api-reference/management-api/user-management/revoke-a-token-of-a-user) - [getList users/api/v1/organization/users](https://docs.mediakind.com/api-reference/management-api/user-management/list-users) - [getGet user details/api/v1/organization/users/{user_id}](https://docs.mediakind.com/api-reference/management-api/user-management/get-user-details) - [delRemove user/api/v1/organization/users/{user_id}](https://docs.mediakind.com/api-reference/management-api/user-management/remove-user) ### Webhook Rules 5 endpoints - [getList Webhook Rules/api/v1/projects/{project_name}/webhook/rules](https://docs.mediakind.com/api-reference/management-api/webhook-rules/list-webhook-rules) - [getGet Webhook Rule/api/v1/projects/{project_name}/webhook/rules/{rule_name}](https://docs.mediakind.com/api-reference/management-api/webhook-rules/get-webhook-rule) - [putCreate or Update Webhook Rule/api/v1/projects/{project_name}/webhook/rules/{rule_name}](https://docs.mediakind.com/api-reference/management-api/webhook-rules/create-or-update-webhook-rule) - [delDelete Webhook Rule/api/v1/projects/{project_name}/webhook/rules/{rule_name}](https://docs.mediakind.com/api-reference/management-api/webhook-rules/delete-webhook-rule) - [getGet Webhook Events/api/v1/projects/{project_name}/webhook/rules/{rule_name}/events](https://docs.mediakind.com/api-reference/management-api/webhook-rules/get-webhook-events) ### Your Profile 14 endpoints - [getGet profileDeprecated/api/profile/](https://docs.mediakind.com/api-reference/management-api/your-profile/get-profile) - [putUpdate profileDeprecated/api/profile/](https://docs.mediakind.com/api-reference/management-api/your-profile/update-profile) - [getList user's organizations and any associated invitation/api/v1/user/organizations](https://docs.mediakind.com/api-reference/management-api/your-profile/list-users-organizations-and-any-associated-invitation) - [getGet organization details/api/v1/user/organizations/{organization_id}](https://docs.mediakind.com/api-reference/management-api/your-profile/get-organization-details) - [patchUpdate organization details (to accept an invitation)./api/v1/user/organizations/{organization_id}](https://docs.mediakind.com/api-reference/management-api/your-profile/update-organization-details-to-accept-an-invitation) - [delLeave an organization/Decline an invite to an organization/api/v1/user/organizations/{organization_id}](https://docs.mediakind.com/api-reference/management-api/your-profile/leave-an-organization-decline-an-invite-to-an-organization) - [getGet profile/api/v1/user/profile](https://docs.mediakind.com/api-reference/management-api/your-profile/get-profile-get) - [patchUpdate profile/api/v1/user/profile](https://docs.mediakind.com/api-reference/management-api/your-profile/update-profile-patch) - [getGet RBAC capability data/api/v1/user/rbac](https://docs.mediakind.com/api-reference/management-api/your-profile/get-rbac-capability-data) - [getGet all user tokens/api/v1/user/tokens](https://docs.mediakind.com/api-reference/management-api/your-profile/get-all-user-tokens) - [postRequest a new token/api/v1/user/tokens](https://docs.mediakind.com/api-reference/management-api/your-profile/request-a-new-token) - [delRevoke all user tokens/api/v1/user/tokens](https://docs.mediakind.com/api-reference/management-api/your-profile/revoke-all-user-tokens) - [getGet a user token by ID/api/v1/user/tokens/{token_id}](https://docs.mediakind.com/api-reference/management-api/your-profile/get-a-user-token-by-id) - [delRevoke a token/api/v1/user/tokens/{token_id}](https://docs.mediakind.com/api-reference/management-api/your-profile/revoke-a-token)