Creating a channel
Written by
Updated at March 6, 2025
Cloud Video interface
REST API
gRPC API
- Open the Cloud Video home page.
- Click Create a channel.
- On the channel creation page, enter:
- Name.
- (Optional) Description.
- Click Create.
Once the channel is created, you will find yourself inside it on the Video tab.
Run this command:
curl \
--request POST \
--url 'https://video.api.cloud.yandex.net/video/v1/channels' \
--header 'Authorization: Bearer <IAM_token>' \
--header 'Content-Type: application/json' \
--data '{
"organization_id": "<organization_ID>",
"title": "<channel_name>"
}'
Where:
<IAM_token>: IAM token required for authenticating with the Cloud Video API.<organization_ID>: ID of the organization to create a Cloud Video channel in.<channel_name>: Name of the channel you are creating in Cloud Video.
Result:
{
"done": true,
"metadata": {
"@type": "type.googleapis.com/yandex.cloud.video.v1.CreateChannelMetadata",
"channelId": "vplcdyphvqik********"
},
"response": {
"@type": "type.googleapis.com/yandex.cloud.video.v1.Channel",
"id": "vplcdyphvqik********",
"organizationId": "bpfaidqca8vd********",
"title": "my-very-first-channel",
"createdAt": "2024-09-16T19:01:10.591128Z",
"updatedAt": "2024-09-16T19:01:10.591128Z"
},
"id": "vplp4vofhojp********",
"description": "Channel create",
"createdAt": "2024-09-16T19:01:10.596734Z",
"createdBy": "ajeol2afu1js********",
"modifiedAt": "2024-09-16T19:01:10.596734Z"
}
Run this command:
grpcurl \
-rpc-header "Authorization: Bearer <IAM_token>" \
-d '{
"organization_id": "<organization_ID>",
"title": "<channel_name>"
}' \
video.api.cloud.yandex.net:443 yandex.cloud.video.v1.ChannelService/Create
Where:
<IAM_token>: IAM token required for authenticating with the Cloud Video API.<organization_ID>: ID of the organization to create a Cloud Video channel in.<channel_name>: Name of the channel you are creating in Cloud Video.
Result:
{
"id": "vplpvkqo2uyv********",
"description": "Channel create",
"createdAt": "2024-09-16T10:36:56.973051Z",
"createdBy": "ajeol2afu1js********",
"modifiedAt": "2024-09-16T10:36:56.973051Z",
"done": true,
"metadata": {
"@type": "type.googleapis.com/yandex.cloud.video.v1.CreateChannelMetadata",
"channelId": "vplcqy2qxkjy********"
},
"response": {
"@type": "type.googleapis.com/yandex.cloud.video.v1.Channel",
"createdAt": "2024-09-16T10:36:56.968240Z",
"id": "vplcqy2qxkjy********",
"organizationId": "bpfaidqca8vd********",
"title": "my-very-first-channel",
"updatedAt": "2024-09-16T10:36:56.968240Z"
}
}