Error Codes

Last updated Oct 19, 2026 This page describes RealtimeKit error codes to help you identify and troubleshoot issues.

WebMobile

ReactWeb ComponentsAngular

All Web Frameworks (Web Components, React, Angular) share the same error codes.

RealtimeKitClient

Error code: 0001

  • Error message: Failed to initialize
  • Possible reason: RealtimeKitClient is not getting initialized.
  • Possible solution: Verify if you initialized the RealtimeKitClient correctly await RealtimeKitClient.init({ ... }). See RealtimeKitClient. If you continue to experience issues, please reach out to Cloudflare support.

Error code: 0002

  • Error message: Failed to join room
  • Possible reason: Indicates a problem with the RealtimeKitClient.
  • Possible solution: The join() method is used to join a meeting room in RealtimeKit. Try calling this method again on the RealtimeKitClient:
await meeting.join();

Once the join room process completes, you'll see the roomJoined event is emitted on the meeting.self namespace.

Error code: 0003

  • Error message: Failed to leave room
  • Possible reason: Indicates a problem with the RealtimeKitClient.
  • Possible solution: The leave() method is used to leave a meeting room in RealtimeKit. Try calling this method again on the RealtimeKitClient:
await meeting.leave();

Error code: 0004

  • Error message: Invalid auth token
  • Possible reason: Indicates a problem with the passed participant auth token.
  • Possible solution: Ensure that the passed auth token is a valid JWT auth token that is not expired yet.

Error code: 0010

  • Error message: Browser not supported
  • Possible reason: Browser is too old and does not support WebRTC
  • Possible solution: Upgrade browser to the latest version. Google Chrome is preferred.

Error code: 0011

  • Error message: HTTP Network Error
  • Possible reason: Either internet issues are present or the API requests are failing due to a faulty auth token among other cases
  • Possible solution: Ensure that the internet connection is proper. Speed test can be performed at fast.com ↗︎. Make sure that the meeting is active and the token has not expired.

Error code: 0012

  • Error message: Websocket Network Error
  • Possible reason: Either internet issues are present or the Websocket connection failed due to a faulty auth token among other cases
  • Possible solution: Ensure that the internet connection is proper. Speed test can be performed at fast.com ↗︎. Make sure that the meeting is active and the token has not expired.

Error code: 0013

  • Error message: Rate Limited
  • Possible reason: SDK API that you are calling is being called too often
  • Possible solution: API rate limiting generally occurs when the webpage is making an unusually high number of requests within a short period. To resolve this, analyze your code to determine why so many requests are being sent and implement optimizations to reduce unnecessary calls.

Error code: 0014

  • Error message: Media connection failed
  • Possible reason: ICE (Interactive Connectivity Establishment) connection failed
  • Possible solution: Make sure your network allows WebRTC connections and turn.cloudflare.com & stun.cloudflare.com are accessible.

Controller

Error code: 0100

  • Error message: Internal exception
  • Possible reason: An unexpected error occurred within the Controller module.
  • Possible solution: Check the logs for more details and retry the operation. If you continue to experience issues, please reach out to Cloudflare support.

Error code: 0101

  • Error message: Permission denied
  • Possible reason: The participant does not have the required permissions to perform the action.
  • Possible solution: Verify the participant's permissions in their respective preset and try again.

Error code: 0102

  • Error message: Prerequisite module missing
  • Possible reason: A required module such as self for the Controller is missing or not initialized.
  • Possible solution: Ensure all prerequisite modules are properly passed in RealtimeKitClient initialization.

RoomNodeClient

Error code: 0200

  • Error message: Internal exception
  • Possible reason: An unexpected error occurred within the RoomNodeClient module.
  • Possible solution: Check the logs for more details and retry the operation. If you continue to experience issues, please reach out to Cloudflare support.

HiveNodeClient

Error code: 0300

  • Error message: Internal exception
  • Possible reason: An unexpected error occurred within the HiveNodeClient module.
  • Possible solution: Check the logs for more details and retry the operation. If you continue to experience issues, please reach out to Cloudflare support.

SocketService

Error code: 0400

  • Error message: Internal exception
  • Possible reason: An unexpected error occurred within the SocketService module.
  • Possible solution: Check the logs for more details and retry the operation. If you continue to experience issues, please reach out to Cloudflare support.

Error code: 0404

  • Error message: Missing prerequisites to establish a websocket connection
  • Possible reason: Required prerequisites for establishing a WebSocket connection are missing.
  • Possible solution: Ensure all prerequisites (e.g., JWT auth token with meetingId, network connectivity) are met. This is an extremely rare case and usually indicates an issue in RealtimeKit SDK.

Chat

Error code: 0500

  • Error message: Internal exception
  • Possible reason: An unexpected error occurred within the Chat module.
  • Possible solution: Check the logs for more details and retry the operation. If you continue to experience issues, please reach out to Cloudflare support.

Error code: 0501

  • Error message: Permission denied
  • Possible reason: The participant does not have the required permissions to perform the action.
  • Possible solution: Verify the participant's permissions in their respective preset and try again.

Error code: 0502

  • Error message: Invalid message body
  • Possible reason: The message body does not conform to the expected format.
  • Possible solution: The Message type is not defined correctly. See Chat.

Error code: 0503

  • Error message: Text message is too large
  • Possible reason: The message exceeds the allowed character limit.
  • Possible solution: Reduce the message length and try again.

Error code: 0504

  • Error message: Message not found by the given ID
  • Possible reason: The message ID provided does not correspond to an existing message.
  • Possible solution: Verify the message ID and ensure the message exists before querying.

Error code: 0505

  • Error message: Action not permitted without joining room
  • Possible reason: The participant attempted to perform an action that requires them to join the meeting first.
  • Possible solution: The participant must first join the meeting using meeting.join() before attempting the action again.

Error code: 0506

  • Error message: Message search is disabled
  • Possible reason: The message search feature is turned off.
  • Possible solution: Please reach out to Cloudflare support for assistance.

Error code: 0510

  • Error message: Invalid channel name
  • Possible reason: The channel name provided does not meet the required format or does not exist.
  • Possible solution: Ensure the channel name is correctly formatted and exists in the system.

Plugin

Error code: 0600

  • Error message: Internal exception
  • Possible reason: An unexpected error occurred within the Plugin module.
  • Possible solution: Check the logs for more details and retry the operation. If you continue to experience issues, please reach out to Cloudflare support.

Error code: 0601

  • Error message: Permission denied
  • Possible reason: The participant does not have the required permissions to perform the action.
  • Possible solution: Verify the participant's permissions in their respective preset and try again.

Error code: 0602

  • Error message: Plugin not found
  • Possible reason: The specified plugin does not exist or is not available.
  • Possible solution: Verify the plugin ID and ensure the plugin is enabled for your meeting.

Error code: 0603

  • Error message: Action not permitted without joining room
  • Possible reason: The participant attempted to perform an action that requires them to join the meeting first.
  • Possible solution: The participant must first join the meeting using meeting.join() before attempting the action again.

Polls

Error code: 0700

  • Error message: Internal exception
  • Possible reason: An unexpected error occurred within the Polls module.
  • Possible solution: Check the logs for more details and retry the operation. If you continue to experience issues, please reach out to Cloudflare support.

Error code: 0705

  • Error message: Action not permitted without joining room
  • Possible reason: The participant attempted to perform an action that requires them to join the meeting first.
  • Possible solution: The participant must first join the meeting using meeting.join() before attempting the action again.

Meta

Error code: 0800

  • Error message: Internal exception
  • Possible reason: An unexpected error occurred within the Meta module.
  • Possible solution: Check the logs for more details and retry the operation. If you continue to experience issues, please reach out to Cloudflare support.

Error code: 0801

  • Error message: Permission denied
  • Possible reason: The participant does not have the required permissions to perform the action.
  • Possible solution: Verify the participant's permissions in their respective preset and try again.

Preset

Error code: 0900

  • Error message: Internal exception
  • Possible reason: An unexpected error occurred within the Preset module.
  • Possible solution: Check the logs for more details and retry the operation. If you continue to experience issues, please reach out to Cloudflare support.

Error code: 0904

  • Error message: Invalid preset configuration
  • Possible reason: The preset configuration contains invalid or incompatible settings.
  • Possible solution: Review your preset configuration and ensure all settings are valid.

Recording

Error code: 1000

  • Error message: Internal exception
  • Possible reason: An unexpected error occurred within the Recording module.
  • Possible solution: Check the logs for more details and retry the operation. If you continue to experience issues, please reach out to Cloudflare support.

Error code: 1001

  • Error message: Permission denied
  • Possible reason: The participant does not have the required permissions to perform the action.
  • Possible solution: Verify the participant's permissions in their respective preset and try again.

Error code: 1004

  • Error message: Recording not started
  • Possible reason: Attempted to stop or interact with a recording that hasn't been started.
  • Possible solution: Start a recording before attempting to stop or interact with it.

Error code: 1005

  • Error message: Recording already in progress
  • Possible reason: Attempted to start a recording when one is already active.
  • Possible solution: Stop the current recording before starting a new one.

Self

Error code: 1100

  • Error message: Internal exception
  • Possible reason: An unexpected error occurred within the Self module.
  • Possible solution: Check the logs for more details and retry the operation. If you continue to experience issues, please reach out to Cloudflare support.

Error code: 1101

  • Error message: Permission denied
  • Possible reason: The participant does not have the required permissions to perform the action.
  • Possible solution: Verify the participant's permissions in their respective preset and try again.

Error code: 1102

  • Error message: Device not found
  • Possible reason: The specified media device (microphone/camera) is not available.
  • Possible solution: Ensure the device is connected and browser permissions are granted.