https://support.tethr.com/hc/en-us/categories/115001740967-Developers Developers
https://support.tethr.com/hc/en-us/sections/115003048847-APIs APIs

Guest user token API

New feature: content organization, collaboration and filtering

This article describes a new feature that may not be available to all users. If you don't see this feature and want to learn more, please contact your Tethr admin.
Section only
Required: You must have a valid authenticated Api User with the CallShare role.

Guest user token API


URL

https://[INSTANCE NAME]/callshare/v1/token


Request

Attribute Type Description
callID string Tethr call ID
     
email string The email address of the person accessing the call


Response

Attribute Type Description
callUrl string The target URL to access the shared call
     
expiration date When the request will expire (default is 8 hours)


Example

POST https://[INSTANCE NAME]/callshare/v1/token 
Authorization: Bearer [TOKEN]
Content-Type: application/json; charset=utf-8

{ "callId": "{CallId}", "email": "{EmailOfWhoWillBeAccessingTheCall}" }


Response

{ "callUrl": "{CallUrl}", "expiration": "{ExpirationDateTime}" }


Once the user navigates to the call URL

  1. They will be asked to either
    1. Sign up and create a password, or
    2. Log in with the created password if they already have signed up with that email.
  2. They will be redirected to the call.
Tip: The user accessing the link needs to own the provided email address in case any password reset or other account related messages are sent during the log in step.