Properties

PreviousTokens NextCreate

Last updated 4 months ago

Properties

The following properties are currently supported inside the token:

td string The ID of your team. You can find it in the under Team section.
rd string The name (friendly url) or UUID of the room. You can use either options depending on what you find more convenient.
ud string (optional) External user identifier, you can set an arbitrary string. This is very useful when you have existing users in your application and you want to cross-reference the users from the DigitalSamba rooms with the users from your system.
u string (optional) User name. If not provided the user will see a screen to input his name before entering. Note: if you are using E2EE, then it is better to set the name through the , otherwise the username in the token will be visible to Digital Samba's backend, since token is part of the URL which is being visited.
initials string (optional) Custom initials for user's tile. By default the application uses as initials the first letter of the first two words of the username. E.g. John Smith has initials JS. But in some cases there could be a title in the name - "Doctor John Smith". In that case you would need to provide custom initials, unless you want the application to use DJ as initials.
role string (optional) Role id or name. If not provided the default room role will be used.
breakoutIdstring (optional) Id of the breakout room which the user will join to.
avatar string optional The url of the user's avatar image. Will be used as an image for user's tile when user's video (camera) is disabled.
iat integer optional The time when the token was issued. Specified as (number of seconds since the epoch).
exp integer optional Token expiration time as (number of seconds since the epoch). Token will be invalid after the specified expiration time. Very useful in combination with nbf if you want the token to be valid only for a concrete time interval.
nbf integer optional
"Not Before" -> Token will be invalid before the specified time comes. Specified as (number of seconds since the epoch). Very useful in combination with exp property if you want the token to be valid only for a concrete timeframe.

PreviousTokens NextCreate

Last updated 4 months ago

The following properties are currently supported inside the token:

td string The ID of your team. You can find it in the under Team section.
rd string The name (friendly url) or UUID of the room. You can use either options depending on what you find more convenient.
ud string (optional) External user identifier, you can set an arbitrary string. This is very useful when you have existing users in your application and you want to cross-reference the users from the DigitalSamba rooms with the users from your system.
u string (optional) User name. If not provided the user will see a screen to input his name before entering. Note: if you are using E2EE, then it is better to set the name through the , otherwise the username in the token will be visible to Digital Samba's backend, since token is part of the URL which is being visited.
initials string (optional) Custom initials for user's tile. By default the application uses as initials the first letter of the first two words of the username. E.g. John Smith has initials JS. But in some cases there could be a title in the name - "Doctor John Smith". In that case you would need to provide custom initials, unless you want the application to use DJ as initials.
role string (optional) Role id or name. If not provided the default room role will be used.
breakoutIdstring (optional) Id of the breakout room which the user will join to.
avatar string optional The url of the user's avatar image. Will be used as an image for user's tile when user's video (camera) is disabled.
iat integer optional The time when the token was issued. Specified as (number of seconds since the epoch).
exp integer optional Token expiration time as (number of seconds since the epoch). Token will be invalid after the specified expiration time. Very useful in combination with nbf if you want the token to be valid only for a concrete time interval.
nbf integer optional
"Not Before" -> Token will be invalid before the specified time comes. Specified as (number of seconds since the epoch). Very useful in combination with exp property if you want the token to be valid only for a concrete timeframe.