Skip to main content

Push-to-talk error codes (mpbx-ptt, mpbx-api-ops)

Raised by /api/v1/ptt/..., /api/v1/me/ptt/... and the audio socket GET /api/v1/me/ptt/channels/{id}/audio (F33). On the audio socket the same codes arrive as {"op":"error","code":...,"detail":...} frames. Guide: push-to-talk.

CodeHTTPMeaningWhat to do
MPBX-PTT-NOT-FOUND404No such channel in the company, or you are not one of its members (the audio socket closes with 4404).Check the channel id, or ask an administrator to add you.
MPBX-PTT-NAME-TAKEN409Another channel of the company already has this name (names are compared without case).Pick another name.
MPBX-PTT-INVALID400A value is out of range: the name (1 to 100 characters), the description (500), max_talk_secs (5 to 300), retention_days (1 to 3650), more than 500 explicit members, a member listed twice, or a members channel without members.Fix the value named in the message.
MPBX-PTT-SOURCE-NOT-FOUND400The department, the team chat group (a 1:1 chat is not a group) or a member is not one of the company's active ones.Pick an existing department, group or user.
MPBX-PTT-DISABLED409The channel is switched off; nobody can talk in it.Switch it on (enabled).
MPBX-PTT-LISTENER-ONLY403A listener asked for the floor.Give the member the talker role, or ptt:priority.
MPBX-PTT-FLOOR-BUSY409Someone else holds the floor (the socket answers busy with the speaker).Wait for the stop frame and ask again.
MPBX-PTT-FLOOR-CONTENDED503The floor changed hands under the request several times in a row.Ask again.
MPBX-PTT-SESSION-REQUIRED403An API key called a member route; push-to-talk is for signed-in people.Sign in as the person.
MPBX-PTT-TOKEN-INVALID400The wake token or the install id is malformed (a PushToTalk token is 64 to 200 hex characters, an FCM token 32 to 4096 printable characters, an install id 8 to 64 of A-Z a-z 0-9 . _ : -), or the push relay refused it.Register the token the system gave the app.
MPBX-PTT-PUSH-UNAVAILABLE503The push relay cannot take the token now (not enrolled yet, unreachable, or no APNs/FCM).Try again later; the app still hears a channel while it is open.
MPBX-PTT-NO-RECORDING404The transmission has no recording: the channel was not recorded, the server has no object store, or it expired with the channel's retention.None.
MPBX-PTT-VERSION-MISMATCH409The channel changed since it was read.Read it again and resend with its new ETag.
MPBX-PTT-UPGRADE-REQUIRED426A plain HTTP request reached the audio socket route.Open it as a WebSocket (HTTP/1.1, version 13).
MPBX-PTT-BAD-FRAME(frame)An audio socket text frame is not talk, release or ping.Send only the documented frames; audio goes in binary frames.