From 572a22d6ff92275e3ca606cafd6b3f645108af88 Mon Sep 17 00:00:00 2001 From: sachaarbonel Date: Wed, 15 May 2024 10:18:51 +0530 Subject: [PATCH] clarify call tokens --- docusaurus/video/docusaurus/docs/api/_common_/storage.mdx | 2 +- .../video/docusaurus/docs/api/basics/authentication.mdx | 5 ++++- .../video/docusaurus/docs/api/recording/recording_calls.mdx | 2 +- 3 files changed, 6 insertions(+), 3 deletions(-) diff --git a/docusaurus/video/docusaurus/docs/api/_common_/storage.mdx b/docusaurus/video/docusaurus/docs/api/_common_/storage.mdx index bf98ab56..335e0d51 100644 --- a/docusaurus/video/docusaurus/docs/api/_common_/storage.mdx +++ b/docusaurus/video/docusaurus/docs/api/_common_/storage.mdx @@ -106,7 +106,7 @@ When transcribing or recording a call, the storage provider is selected in this 2. If specified at the call type level, the storage provider designated for that call type will be used. 3. If neither applies, Stream S3 storage will be used. -Note: All Stream applications have Stream S3 storage enabled by default, which you can refer to as `"stream-s3"` in the configuration. +> **Note:** All Stream applications have Stream S3 storage enabled by default, which you can refer to as `"stream-s3"` in the configuration. diff --git a/docusaurus/video/docusaurus/docs/api/basics/authentication.mdx b/docusaurus/video/docusaurus/docs/api/basics/authentication.mdx index 30eb3d79..6a528d35 100644 --- a/docusaurus/video/docusaurus/docs/api/basics/authentication.mdx +++ b/docusaurus/video/docusaurus/docs/api/basics/authentication.mdx @@ -372,7 +372,10 @@ You need to provide the generated tokens to the client SDKs. Stream SDKs accept ## Call tokens -Call tokens contain a list of call IDs. If a user is authenticated with a call token, they can only access the specified calls. They are helpful if you want to limit call access, but you want to avoid managing call members (an example: a pay-pre-view link for livestreams, with hundreds of thousands of expected viewers). + +Call tokens contain a list of call IDs. When a user utilizes a call token, they will automatically be assigned the membership role for all the calls specified in the token’s claims. Additionally, the token may optionally include alternative roles, such as admin or moderator. + +> **Note:** Call tokens are designed to grant additional access, not restrict it. Most call types let regular users join calls. If all users can access any call, call tokens won't change this. Remove call access from the user role and grant it to specific members instead. diff --git a/docusaurus/video/docusaurus/docs/api/recording/recording_calls.mdx b/docusaurus/video/docusaurus/docs/api/recording/recording_calls.mdx index 8493d3b8..2eea8480 100644 --- a/docusaurus/video/docusaurus/docs/api/recording/recording_calls.mdx +++ b/docusaurus/video/docusaurus/docs/api/recording/recording_calls.mdx @@ -13,7 +13,7 @@ Call recording is done by Stream server-side and later stored on AWS S3. There i By default, calls will be recorded as mp4 video files. You can configure recording to only capture the audio. -Note: by default, recordings contain all tracks mixed in a single file. You can follow the discussion [here](https://github.com/GetStream/protocol/discussions/247) if you are interested in different ways to record calls. +> **Note:** by default, recordings contain all tracks mixed in a single file. You can follow the discussion [here](https://github.com/GetStream/protocol/discussions/247) if you are interested in different ways to record calls. ## Start and stop call recording