Skip to content
MZAP
Search
Ctrl
K
Cancel
Website
Select theme
Dark
Light
Auto
Getting Started
Installation
Quick Start
System Requirements
Concepts
Zones and Players
Matrix Routing
Audio Devices
Workspaces
EQ & Compressor Presets
User Guide
Media Library
Playlists
Jingles
Scheduler
EQ & Compressor
Input Capture
MCP Integration
MCP Overview
MCP Tools Reference
MCP Examples
API Reference
Overview
MZAP.Api
Returns application branding constants
Health
API health check
Auth
Get authentication status
Login with username and password
Logout and invalidate session
Lock the UI (admin only, invalidates current session)
Users
List all users (admin only)
Create a new user (admin only)
Update user role/enabled state (admin only)
Delete a user (admin only, can't delete last admin)
Change a user's password (admin or self)
Regenerate API key for a user (admin only)
Get the full API key for a user (admin only)
Devices
Initialize audio engine
Get all available audio devices
Get a specific device by ID
Refresh audio devices (hot-plug support)
Check if audio engine is initialized
Toggle device favorite status
Input Devices
Get all audio input devices
Toggle input device favorite status
Zones
Get all zones from all devices
Get a specific zone by ID
Get all zones for a specific device
Rename a zone
Set volume for a specific zone
Set mute state for a specific zone
Set equalizer settings for a specific zone
Set compressor settings for a specific zone
Toggle zone favorite status
Players
Get all players
Create a new player
Rename a player
Delete a player
Start playback
Pause playback
Stop playback
Seek to a specific position
Set player volume
Set player mute state
Load a file or stream URL into the player
Attach player to zones
Detach player from zones
Skip to next track in playlist
Go to previous track in playlist
Jump to a specific track in playlist
Assign a playlist to the player
Toggle player favorite status
Set player PFL (Pre-Fader Listen) state
Set player crossfade duration
Playlists
Get all playlists
Create a new playlist
Get a playlist by ID
Update/rename a playlist
Delete a playlist
Import playlist from M3U or PLS file
Export playlist to file
Add tracks to playlist
Remove tracks from playlist
Set playback mode
Reorder tracks in playlist
Duplicate a playlist
Verify playlist track file paths
Toggle playlist favorite status
Matrix
Get the complete routing matrix
Route a player to a zone
Unroute a player from a zone
Settings
Get application settings
Update application settings
Open the log files folder in the system file explorer
Streaming
Subscribe to all entity changes and state updates via Server-Sent Events (SSE)
Subscribe to VU meter level updates via Server-Sent Events (SSE)
Subscribe to events for a specific player via Server-Sent Events (SSE)
Jingles
Get all jingles
Create a new jingle
Update jingle settings
Delete a jingle
Play a jingle on target players or zones
Stop a playing jingle
Presets
Get all EQ presets
Create a new EQ preset
Update an EQ preset
Delete an EQ preset
Get all compressor presets
Create a new compressor preset
Update a compressor preset
Delete a compressor preset
Scheduler
Get all scheduled tasks
Create a new scheduled task
Get a scheduled task by ID
Update an existing scheduled task
Delete a scheduled task
Enable a scheduled task
Disable a scheduled task
Manually trigger a scheduled task
Get scheduler operational status
Get task execution log
Workspace
Get current workspace metadata
Create a new empty workspace
Save workspace to a file
Load workspace from a file
Check for device mismatches before loading
Update window position and size
Update FlexLayout state
Update UI state
Mark workspace as having unsaved changes
Get user-to-resource assignments for current workspace (admin only)
Update user-to-resource assignments (admin only)
Library
Search media files in the library
Get a media file by ID
Get library statistics
Get all library folders
Add a folder to the library
Remove a folder and its files from the library
Scan a specific library folder
Scan all library folders
License
Gets the current license status
Activates a license key on this machine
Forces a license re-check against the server
Deactivates the license on this machine
Starts a trial license for this machine
Generates a .req file content for offline activation
Loads a .lic file for offline activation
Update
Get current update status
Force an immediate update check
Download the latest installer and launch it
Licensing
License Activation
Offline Activation
License Troubleshooting
Changelog
Changelog
Website
Select theme
Dark
Light
Auto
Lock the UI (admin only, invalidates current session)
POST
/api/auth/lock
Responses
Section titled “ Responses ”
200
Section titled “200 ”
OK
401
Section titled “401 ”
Unauthorized
403
Section titled “403 ”
Forbidden
