Skip to main content

Error codes

Every MonoPbx error carries a stable code of the form MPBX-<AREA>-<NAME>, for example MPBX-CONFIG-MISSING. The API returns it in the code field of an RFC 9457 problem response, and logs include it, so a code can be searched for directly.

Configuration (MPBX-CONFIG-*)​

CodeMeaningWhat to do
MPBX-CONFIG-MISSINGA required configuration value is not set.Set it in mpbx.toml or the matching environment variable.
MPBX-CONFIG-INVALIDThe configuration could not be parsed or failed validation.Fix the reported key or value.
MPBX-CONFIG-FILE-NOT-FOUNDThe configuration file path does not exist.Check the path passed to the server.
MPBX-CONFIG-UNKNOWN-FLAGAn unknown feature flag name was set.Remove it or correct its spelling.

All areas​

The pages below are generated from the engineering error catalogue, so they list every code the server can return.

Area
Agent view error codes (mpbx-api)
AI error codes (mpbx-ai)
Alert centre and log level error codes (mpbx-alerts)
API error codes (mpbx-api)
Audit error codes (mpbx-audit)
Auth error codes (mpbx-auth)
Backup and restore error codes (mpbx-backup)
Calendar sync error codes (mpbx-calendar-sync, mpbx-api-directory)
Call control error codes (mpbx-api call-control routes, mpbx-b2bua control)
Call error codes (mpbx-api calls routes, mpbx-b2bua originate)
Call history error codes (mpbx-cdr)
Certificate and ACME error codes (mpbx-certs)
Team chat error codes (mpbx-chat)
Common error codes (mpbx-common)
Multi Company console and branding error codes (mpbx-api-ops)
Conference error codes (mpbx-b2bua)
CRM error codes (mpbx-crm)
Directory sync error codes (mpbx-dirsync, mpbx-api-directory::config::directory_sync)
E-mail error codes (mpbx-email)
Event error codes (mpbx-events)
Fax error codes (mpbx-fax)
File storage error codes (mpbx-files)
Call flow error codes (mpbx-flows)
Statuses and forwarding error codes (mpbx-api, mpbx-forwarding)
Hot-desk error codes (mpbx-api-telephony)
Omnichannel inbox error codes (mpbx-channels)
Install secret error codes (mpbx-installer)
IVR and prompt error codes (mpbx-ivr)
Media control error codes (mpbx-media-control, rtpengine NG)
Media error codes (mpbx-media-app, mpbx-media)
Admin IP allow-list error codes (mpbx-api-ops)
Presence error codes (mpbx-presence)
Data-subject request error codes (mpbx-privacy, mpbx-api-ops)
Call recording error codes (mpbx-recording)
Report error codes (mpbx-api reports, mpbx-cdr)
Secrets at rest error codes (mpbx-secrets)
HTTP server error codes (mpbx run)
SMS error codes (mpbx-sms)
Single sign-on error codes (mpbx-oidc, mpbx-auth::sso)
STIR/SHAKEN error codes (mpbx-stir-shaken)
Storage error codes (mpbx-storage, PostgreSQL)
Supervisor tools error codes (mpbx-b2bua, mpbx-api)
Support bundle and SIP trace error codes (mpbx-support)
Switchboard error codes (mpbx-api switchboard routes, mpbx-b2bua switchboard)
Transcript error codes (mpbx-transcripts)
Transfer error codes (mpbx-b2bua)
SIP trunk error codes (mpbx-b2bua, trunks)
Upgrade, config export and self-test error codes (mpbx-upgrade)
Voicemail error codes (mpbx-voicemail)
Webhook error codes (mpbx-webhooks)