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-*)
| Code | Meaning | What to do |
|---|---|---|
MPBX-CONFIG-MISSING | A required configuration value is not set. | Set it in mpbx.toml or the matching environment variable. |
MPBX-CONFIG-INVALID | The configuration could not be parsed or failed validation. | Fix the reported key or value. |
MPBX-CONFIG-FILE-NOT-FOUND | The configuration file path does not exist. | Check the path passed to the server. |
MPBX-CONFIG-UNKNOWN-FLAG | An unknown feature flag name was set. | Remove it or correct its spelling. |
More areas are added here as they are implemented.