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.
| Code | HTTP | Meaning | What to do |
|---|---|---|---|
MPBX-PTT-NOT-FOUND | 404 | No 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-TAKEN | 409 | Another channel of the company already has this name (names are compared without case). | Pick another name. |
MPBX-PTT-INVALID | 400 | A 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-FOUND | 400 | The 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-DISABLED | 409 | The channel is switched off; nobody can talk in it. | Switch it on (enabled). |
MPBX-PTT-LISTENER-ONLY | 403 | A listener asked for the floor. | Give the member the talker role, or ptt:priority. |
MPBX-PTT-FLOOR-BUSY | 409 | Someone else holds the floor (the socket answers busy with the speaker). | Wait for the stop frame and ask again. |
MPBX-PTT-FLOOR-CONTENDED | 503 | The floor changed hands under the request several times in a row. | Ask again. |
MPBX-PTT-SESSION-REQUIRED | 403 | An API key called a member route; push-to-talk is for signed-in people. | Sign in as the person. |
MPBX-PTT-TOKEN-INVALID | 400 | The 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-UNAVAILABLE | 503 | The 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-RECORDING | 404 | The 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-MISMATCH | 409 | The channel changed since it was read. | Read it again and resend with its new ETag. |
MPBX-PTT-UPGRADE-REQUIRED | 426 | A 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. |