Getting Oracle Radio WebSocket Channel Information
Send a GET_CHANNEL_INFO message to get the metadata for a Radio channel.
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 request is resolved 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 GET_CHANNEL_INFO message as a JSON text message.
| Name | Data type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
type | string | Yes | None | Must be GET_CHANNEL_INFO. | Identifies the channel-information operation. |
channel | string | No | default | Channel name. | Channel for which to return metadata. |
{
"type": "GET_CHANNEL_INFO",
"channel": "operations"
}Responses
The following table lists the messages the client can receive and explains their purpose.
| Message type | Kind | Description |
|---|---|---|
CHANNEL_INFO | Direct response | Returns channel metadata, including its mode, owner, and creation date and time when available. |
ERROR | Error | Indicates that the request message is invalid or couldn't be processed. |
CHANNEL_INFO 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_INFO. |
channel | string | Yes | Channel name. |
mode | string | Yes | Channel mode. |
owner | string | No | Channel owner. |
createdAt | string | No | Creation date and time in ISO 8601 format. |
displayName | string | No | Channel display name. |
description | string | No | Channel description. |
isPersistent | boolean | No | Whether the channel is persistent. |
isDefault | boolean | No | Whether this is the default channel. |
maxSubscribers | integer | No | Maximum subscriber count for the channel. |
{
"type": "CHANNEL_INFO",
"channel": "operations",
"mode": "normal",
"owner": "admin",
"createdAt": "2026-09-01T12:00:00Z",
"displayName": "Operations",
"description": "Primary operations channel",
"isPersistent": true,
"isDefault": false,
"maxSubscribers": 1000
}