Skip to main content

Switchboard error codes (mpbx-api switchboard routes, mpbx-b2bua switchboard)

Returned by the switchboard routes (W6-WEB-01b): GET /api/v1/switchboard/calls and POST /api/v1/switchboard/calls/{id}/transfer|park|drop; MPBX-BOARD-CALL-NOT-FOUND and MPBX-BOARD-FORBIDDEN are also the codes of the engine's B2bua::drop_call. A transfer or park also returns the transfer codes of transfers.md (MPBX-XFER-STATE: the call is not answered or another transfer runs; MPBX-XFER-TARGET: the dial plan refused the destination, or the park slot is full; MPBX-XFER-FORBIDDEN: the freed party is not a device of the company). Without a call engine every route is 503 MPBX-CALL-ENGINE-UNAVAILABLE, and an API key is 403 MPBX-CALL-SESSION-REQUIRED (calls.md). Messages never contain numbers or names. Guide: Switchboard and BLF panel.

CodeHTTPMeaningWhat to do
MPBX-BOARD-CALL-NOT-FOUND404No live call with this id that you may act on: it ended, it is another company's, or none of its parties is a member of a department your calls:control covers (these look the same on purpose).Refresh the list; ask an administrator to extend your Receptionist grant if the call should be yours to handle.
MPBX-BOARD-FORBIDDEN403The call is an emergency call: it is listed, never transferred, parked or dropped.Leave it; the caller hangs up on the phone.
MPBX-BOARD-ORBIT400The park slot is not one of the company's (GET /park-slots lists them: 0 to orbits - 1 of the dial codes).Pick a listed slot.
MPBX-BOARD-UNSUPPORTED503The call engine of this server has no switchboard (an engine build without it).Use a node that runs the current engine.

Also: MPBX-RATE-LIMITED (429, api.md) beyond 60 call-control requests a minute per user.

Audit records (W3-AUD-01): switchboard.call_transferred (details destination, by, caller_user_id, callee_user_id, result: ok or the error code), switchboard.call_parked (orbit, by, the parties, result), switchboard.call_dropped (state, the parties, result). An attempt on a call outside your reach or on an emergency call is recorded with outcome denied (result MPBX-BOARD-CALL-NOT-FOUND or MPBX-BOARD-FORBIDDEN). Saving your BLF panel is me.blf_keys_changed (details keys: how many).