Getting Oracle Radio WebSocket Channel Status
Send a CHANNEL_STATUS message to determine whether a Radio channel is idle or busy and inspect its current talk-floor state.
Permissions and Prerequisites
The following permissions and prerequisites apply to this operation.
| Requirement | Value |
|---|---|
| Authentication | Complete the supported authentication path for the client before sending this operation. See authentication. |
| Radio permission | No operation-specific Radio permission is defined for this message. |
| Channel access | The channel name is interpreted in the authenticated user's Radio channel scope. The contract doesn't require a live channel subscription. |
| Session state | The WebSocket connection must be open. |
Request
Send the CHANNEL_STATUS message as a JSON text message.
| Name | Data type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
type | string | Yes | None | Must be CHANNEL_STATUS. | Identifies the channel-status operation. |
channel | string | No | default | Channel name. | Channel for which to return status. |
{
"type": "CHANNEL_STATUS",
"channel": "operations"
}Responses
The following table lists the messages the client can receive and explains their purpose.
| Message type | Kind | Description |
|---|---|---|
CHANNEL_STATUS | Direct response | Returns channel metadata, subscriber count, and current talk-floor state. |
ERROR | Error | Indicates that the request message is invalid or couldn't be processed. |
CHANNEL_STATUS Response
The following table describes the response properties, their data types, and whether they are required.
| Name | Data type | Required | Description |
|---|---|---|---|
type | string | Yes | Response type. The value is CHANNEL_STATUS. |
channel | string | Yes | Channel name. |
mode | string | No | Channel mode. |
owner | string | No | Channel owner. |
subscriberCount | integer | No | Current subscriber count. |
busy | boolean | Yes | Whether the channel is busy. |
busyBy | string | No | Username of the current talk-token holder. |
busyByDisplayName | string | No | Display name of the current talk-token holder. |
priority | integer | No | Priority of the current talk token. |
expiresAt | string | No | Talk-token expiration date and time in ISO 8601 format. |
isTransmitting | boolean | No | Whether a user is currently transmitting. |
{
"type": "CHANNEL_STATUS",
"channel": "operations",
"mode": "normal",
"owner": "admin",
"subscriberCount": 5,
"busy": true,
"busyBy": "dispatcher1",
"busyByDisplayName": "Dispatch One",
"priority": 50,
"expiresAt": "2026-09-02T14:35:00Z",
"isTransmitting": true
}