management.md
Build with the Management API
The Management API is the control plane for MK.IO. Use it when you need to create projects, manage users and teams, issue tokens, assign payment methods, enable metrics, or configure webhook rules that other workflows depend on.
API overview
| Detail | Value |
|---|---|
| Base path | /api/v1/ |
| Scope | Organization and project |
| Reference | Management API reference |
How the Management API fits into other workflows
You often use this API before you use anything else:
- Create a project and assign billing.
- Grant access to the right users and teams.
- Create or rotate tokens for automation.
- Add webhook rules so media or fleet workflows can notify your application.
That makes the Management API the setup and governance layer for the rest of the platform.
Common workflow patterns
Provision and govern an organisation
- Create a project and assign billing
- Set up users and teams
- Create tokens for automation
- Configure webhook rules
- Monitor usage and billing
Guides
- Users and teams: Understand users, invites, teams, roles, scopes, and the JSON Patch operations used to evolve team access.
- Tokens: Create full-access or restricted tokens, inspect token metadata, and revoke user or organization tokens.
- Organizations and invites: Inspect accessible organizations, accept pending invitations, and leave or decline organization access cleanly.
- Webhook rules: Register webhook destinations, choose events, and inspect event delivery status for each rule.
- Usage and billing: Inspect current project usage, run date-range reports, assign payment methods, and enable metrics export.
Workflow guide
- Provision org and users: Create a project, assign billing, then move into access and token setup for the people and systems that will use it.