Skip to main content

HooT-API (1.0.0)

Download OpenAPI specification:Download

WebLogin

HooT's WebLogin API allows you to record or register login event of a user. Authorization-Token and x-hoot-instance that signifies the instance name are passed as headers. The API returns a JSON object with two parameters: user id as user_id and user_uuid as unique user id. This unique user id is used to identify the user across the conferencing system

Authorizations:
Authorization
header Parameters
Authorization
required
string(^[\w-]*\.[\w-]*\.[\w-]*$)
Example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

Auth JWT token from IDP

x-hoot-instance
required
string
Default: Generic
Enum: "Generic" "Speakerbus"
Example: Generic

Instance name of the requesting entity

Request Body schema: application/json

In the request body, the user profile is passed. This user profile is generated when we have logged in/signed up through the third-party authentication system Auth0. The user profile is a JSON object, which looks like the object shown in Example-BB.

given_name
string non-empty
family_name
string non-empty
nickname
string non-empty
name
required
string non-empty
picture
string non-empty
locale
string non-empty
updated_at
string non-empty
email
required
string non-empty ^[a-zA-Z0-9.a-zA-Z0-9.!#$%&'*+-/=?^_`{|}~]+@[...
email_verified
boolean
sub
required
string non-empty ^(?!\s*$).+
uuid
string [ 1 .. 36 ] characters ^(?!\s*$).+
username
string non-empty
idpRegistered
boolean

Responses

Request samples

Content type
application/json
{
  • "given_name": "Jane",
  • "family_name": "Doe",
  • "nickname": "Jane.Doe",
  • "name": "Jane Doe",
  • "locale": "en-GB",
  • "updated_at": "2022-03-12T10:31:28.797Z",
  • "email": "jane.doe@example.com",
  • "email_verified": true,
  • "sub": "google-oauth2|108203387585675245469"
}

Response samples

Content type
application/json
{
  • "user_id": "dev@mpsc.io",
  • "user_uuid": "728de4da-e94f-4367-80e7-c672814a55e6"
}

CheckConferenceByID

Use HooT's CheckConferenceByID API to check if a conference is alive. The API takes Conference ID coined conf_id as a path parameter. Authorization-Token and x-hoot-instance that signifies the instance name are passed as headers. The API returns a 200 response code in case a conference with the given Conference ID is alive, else it returns a 404 reponse code.

Authorizations:
Authorization
path Parameters
conf_id
required
string non-empty ^(?!\s*$).+
Example: 6e19e88d-634f-4872-826b-2d26503caba1

unique conference id used to identify a conference

header Parameters
Authorization
required
string non-empty (^[\w-]*\.[\w-]*\.[\w-]*$)
Example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

Auth JWT token from IDP

x-hoot-instance
required
string
Default: Generic
Enum: "Generic" "Melco" "Speakerbus"
Example: Generic

Instance name of the requesting entity

Responses

UserLastJoinedConferences

Use HooT's UserLastJoinedConferences API to fetch list of conferences recently joined by the user within a valid range of values (to,from). Authorization-Token and x-hoot-instance that signifies the instance name are passed as headers. Unique user id as user_uuid is passed as a path parameter to identify the user for whom the list of last joined conferences is to be retrieved. If from is greater than maximum number of conferences joined by the user, then 204 is returned as the response code with no reponse body. If to is greater than the maximum number of conferences joined, then conferences are returned within index range of (from,maximum number of conferences joined).

Authorizations:
Authorization
path Parameters
user_uuid
required
string [ 1 .. 36 ] characters ^(?!\s*$).+
Example: a5c818fb-bd18-41f6-a030-745ff9fe7f21

unique user id used to identify a user

query Parameters
from
integer

from index

to
integer
Default: -1

to index (-1 means all)

header Parameters
Authorization
required
string non-empty (^[\w-]*\.[\w-]*\.[\w-]*$)
Example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

Auth JWT token from IDP

x-hoot-instance
required
string
Default: Generic
Enum: "Generic" "Melco" "Speakerbus"
Example: Generic

Instance name of the requesting entity

Responses

Response samples

Content type
application/json
[]

UserInvitedToConferences

Use HooT's UserInvitedToConferences API to fetch list of conferences a user has been invited to, within a valid range of values (to,from). Authorization-Token and x-hoot-instance that signifies the instance name are passed as headers. Unique user id as user_uuid is passed as a path parameter to identify the user for whom the list of invited conferences is to be retrieved. If from is greater than maximum number of conferences the user has been invited to, then 204 is returned as the response code with no reponse body. If to is greater than the maximum number of conferences the user has been invited to, then conferences are returned within index range of (from,maximum number of conferences user has been invited to).

Authorizations:
Authorization
path Parameters
user_uuid
required
string [ 1 .. 36 ] characters ^(?!\s*$).+
Example: a5c818fb-bd18-41f6-a030-745ff9fe7f21

unique user id used to identify a user

query Parameters
from
integer >= 0

from index

to
integer
Default: -1

to index (-1) means all or max

header Parameters
Authorization
required
string(^[\w-]*\.[\w-]*\.[\w-]*$)
Example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

Auth JWT token from IDP

x-hoot-instance
required
string
Default: Generic
Enum: "Generic" "Melco" "Speakerbus"
Example: Generic

Instance name of the requesting entity

Responses

Response samples

Content type
application/json
[]

UserFavouriteConference

HooT's UserFavouriteConference API fetches the list of conferences a user has marked as favourite. The API returns the list of all the conferences user has marked as favourite in the form of a JSON object. Unique user id as user_uuid is passed as a path parameter to identify the user for whom the favoruite conferences are to be retrieved. Authorization-Token and x-hoot-instance that signifies the instance name are passed as headers.

Authorizations:
Authorization
path Parameters
user_uuid
required
string [ 1 .. 36 ] characters ^(?!\s*$).+
Example: a5c818fb-bd18-41f6-a030-745ff9fe7f21

unique user id used to identify a user

header Parameters
Authorization
required
string non-empty (^[\w-]*\.[\w-]*\.[\w-]*$)
Example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

Auth JWT token from IDP

x-hoot-instance
required
string
Default: Generic
Enum: "Generic" "Melco" "Speakerbus"
Example: Generic

Instance name of the requesting entity

Responses

Response samples

Content type
application/json
[]

UserSetFavouriteConference

You can leverage HooT's UserSetFavouriteConference API to mark a conference as favourite for a particular user. On successful addition to the Favourites list, the API will return a 202 response code. Conference Id as conf_id and Unique user id as user_uuid are passed as path parameters to identify the conference and user respectively. Authorization-Token and x-hoot-instance that signifies the instance name are passed as headers.

Authorizations:
Authorization
path Parameters
user_uuid
required
string [ 1 .. 36 ] characters ^(?!\s*$).+
Example: a5c818fb-bd18-41f6-a030-745ff9fe7f21

unique user id used to identify a user

conf_id
required
string non-empty ^(?!\s*$).+
Example: 6e19e88d-634f-4872-826b-2d26503caba1

unique conference id used to identify a conference

header Parameters
Authorization
required
string non-empty (^[\w-]*\.[\w-]*\.[\w-]*$)
Example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

Auth JWT token from IDP

x-hoot-instance
required
string
Default: Generic
Enum: "Generic" "Melco" "Speakerbus"
Example: Generic

Instance name of the requesting entity

Responses

UserUnsetFavouriteConference

You can leverage HooT's UserUnsetFavouriteConference API to remove a conference from favourites for a particular user. On successful removal from Favourites, the API will return a 202 response code. Conference Id as conf_id and Unique user id as user_uuid are passed as path parameters to identify the conference and user respectively. Authorization-Token and x-hoot-instance that signifies the instance name are passed as headers.

Authorizations:
Authorization
path Parameters
user_uuid
required
string [ 1 .. 36 ] characters ^(?!\s*$).+
Example: a5c818fb-bd18-41f6-a030-745ff9fe7f21

unique user id used to identify a user

conf_id
required
string non-empty ^(?!\s*$).+
Example: 6e19e88d-634f-4872-826b-2d26503caba1

unique conference id used to identify a conference

header Parameters
Authorization
required
string non-empty (^[\w-]*\.[\w-]*\.[\w-]*$)
Example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

Auth JWT token from IDP

x-hoot-instance
required
string
Default: Generic
Enum: "Generic" "Melco" "Speakerbus"
Example: Generic

Instance name of the requesting entity

Responses

SearchConferences

Leverage HooT's SearchConferences API to fetch list of conferences that include the search string coined search_string, passed a path parameter. Authorization-Token and x-hoot-instance that signifies the instance name are passed as headers. count is passed as a query parameter that signifies the limit to number of search results.By default, it's -1 which means returns all the search results. Conferences found that includes the search term in conference name, will be returned as elements of a list object with a 200 response code, as shown in example-1.

Authorizations:
Authorization
path Parameters
search_string
required
string >= 3 characters ^[a-zA-Z0-9_]*$
Example: searchterm1

Search term that should be present in the conference name.

query Parameters
count
integer
Default: -1

limit result to number of results (-1 means all)

header Parameters
Authorization
required
string

Auth JWT token from IDP

x-hoot-instance
required
string
Default: Generic

Instance name of the requesting entity

Responses

Response samples

Content type
application/json
No sample

SayHello

Authorizations:
Authorization
header Parameters
Authorization
string

Auth JWT token from IDP

x-hoot-instance
string
Default: Generic

Instance name of the requesting entity

Request Body schema: application/json
type
string
Enum: "registry" "coremx" "login" "other"
object (coremx)

The CoreMX implementation

Responses

Request samples

Content type
application/json
No sample

CreateConference

Use HooT's CreateConference API to seamlessly create new conferences. The API returns a JSON object containing the conference details, in case the conference has been successfully created, with a 200 reponse code. Authorization-Token and x-hoot-instance that signifies the instance name are passed as headers. Conference name as conference_name is passed a path parameter.

Authorizations:
Authorization
path Parameters
conference_name
required
string non-empty ^(?!\s*$).+
Example: Test-conf123

conference name by which a user can identify the conference.

header Parameters
Authorization
required
string non-empty (^[\w-]*\.[\w-]*\.[\w-]*$)
Example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

Auth JWT token from IDP

x-hoot-instance
required
string
Default: Generic
Enum: "Generic" "Speakerbus" "Melco"
Example: Generic

Instance name of the requesting entity

Request Body schema: application/json

Request body accepts two mandatory parameters: moderators and participants. These are list objects containing email id of the moderators/participants you want to include in the conference. In case you want to create a conference with no moderators/participants(other than yourself), assign an empty list to both the parameters.

moderators
required
Array of strings
participants
required
Array of strings
object (features)

Responses

Request samples

Content type
application/json
{
  • "moderators": [
    ],
  • "participants": [
    ],
  • "features": {
    }
}

Response samples

Content type
application/json
{}

Status

readiness & liveness probe

Authorizations:
Authorization

Responses

Xform

HooT's Get Base64 URL API takes Base64 encoded conference URL coined b64_URL as a path parameter and returns the actual join URL as a JSON String with 302 response code. If the encoded URL is not valid, the API returns a 404 response code.

Authorizations:
Authorization
path Parameters
b64_URL
required
string^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[...
Example: TWFueSBoYW5kcyBtYWtlIGxpZ2h0IHdvcmsu

conference URL in encoded in Base 64 format

header Parameters
Authorization
required
string non-empty (^[\w-]*\.[\w-]*\.[\w-]*$)
Example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

Auth JWT token from IDP

x-hoot-instance
required
string
Default: Generic
Enum: "Generic" "Melco" "Speakerbus"
Example: Generic

Instance name of the requesting entity

Responses

DeleteConference

Use the DeleteConference API to delete any conference. The API returns a 200 response code when a conference has been successfully deleted, else it will return a 404 response code if no conference is found with the given conference id. Authorization-Token and x-hoot-instance that signifies the instance name are passed as headers. Conference ID as conf_id is passed as a path parameter to uniquely identify the conference.

Authorizations:
Authorization
path Parameters
conf_id
required
string non-empty ^(?!\s*$).+
Example: 6e19e88d-634f-4872-826b-2d26503caba1

unique conference id used to identify a conference

header Parameters
Authorization
required
string non-empty (^[\w-]*\.[\w-]*\.[\w-]*$)
Example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

Auth JWT token from IDP

x-hoot-instance
required
string
Default: Generic
Enum: "Generic" "Melco" "Speakerbus"
Example: Generic

Instance name of the requesting entity

Responses

Response samples

Content type
application/json
No sample

AddUserSearchString

Use HooT's AddUserSearchString API to add a search term to user's search history. The API takes the user's unique user id as user_id and search term as search_string,as path parameters. Authorization-Token and x-hoot-instance that signifies the instance name are passed as headers. On successfully adding the search term, the API will return a 200 response code.

Authorizations:
Authorization
path Parameters
user_id
required
string [ 1 .. 36 ] characters ^(?!\s*$).+
Example: a5c818fb-bd18-41f6-a030-745ff9fe7f21

unique user id to identify a user

search_string
required
string non-empty ^[a-zA-Z0-9_]*$
Example: searchterm1

search term to be added to user's search history

header Parameters
Authorization
required
string non-empty (^[\w-]*\.[\w-]*\.[\w-]*$)
Example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

Auth JWT token from IDP

x-hoot-instance
required
string
Default: Generic
Enum: "Generic" "Melco" "Speakerbus"
Example: Generic

Instance name of the requesting entity

Responses

UserSearchStrings

Use HooT's UserSearchStrings API to get a list of user's search history. The API takes the user's unique user id as user_id as a path parameter. Authorization-Token and x-hoot-instance that signifies the instance name are passed as headers. On successful execution, the API will return a JSON object as shown in example-1,with a 200 response code.

Authorizations:
Authorization
path Parameters
user_id
required
string [ 1 .. 36 ] characters ^(?!\s*$).+
Example: a5c818fb-bd18-41f6-a030-745ff9fe7f21

unique user id to identify a user

header Parameters
Authorization
required
string non-empty (^[\w-]*\.[\w-]*\.[\w-]*$)
Example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

Auth JWT token from IDP

x-hoot-instance
required
string
Default: Generic
Enum: "Generic" "Melco" "Speakerbus"
Example: Generic

Instance name of the requesting entity

Responses

Response samples

Content type
application/json
[
  • "searchterm1",
  • "searchterm2"
]

CheckEntryCode

Authorizations:
Authorization
Request Body schema: application/json
code
string

Responses

Request samples

Content type
application/json
{
  • "code": "string"
}

EditConference

Leverage HooT's EditConference API to add/remove participants from an existing conference. Additionally you can use this API to add existing participants or new participants as moderators to the conference. The API takes Conference ID as conf_id as a path parameter to uniquely identify the conference. Authorization-Token and x-hoot-instance that signifies the instance name are passed as headers. On successfully edit, the API returns a 200 reponse code with a JSON object as shown in example-1.

Authorizations:
Authorization
path Parameters
conf_id
required
string non-empty ^(?!\s*$).+
Example: 6e19e88d-634f-4872-826b-2d26503caba1

unique conference id used to identify a conference

header Parameters
Authorization
required
string(^[\w-]*\.[\w-]*\.[\w-]*$)
Example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

Auth JWT token from IDP

x-hoot-instance
required
string
Default: Generic
Enum: "Generic" "Speakerbus" "Melco"
Example: Generic

Instance name of the requesting entity

Request Body schema: application/json

Request body accepts three mandatory parameters: new moderators as new_moderators,new participants as new_participants and remove users as remove_users .These are list objects containing email id of the moderators/participants you want to include/remove from the conference. In case you want to leave one of these parameters blank, just assign an empty list to the said parameter

new_moderators
required
Array of strings
new_participants
required
Array of strings
remove_users
required
Array of strings
object (features)

Responses

Request samples

Content type
application/json
{
  • "new_moderators": [
    ],
  • "new_participants": [
    ],
  • "remove_users": [
    ]
}

Response samples

Content type
application/json
No sample

AllUsersofConference

Use HooT's AllUsersofConference API to fetch the list of all participants and moderators of a conference. The API takes conference ID as conf_id as a path param to identify the conference. If a conference is found with the given conference ID, the API will return a JSON object with two parameters moderators and participants containing the list of moderators and participants in the conference respectively. Authorization-Token and x-hoot-instance that signifies the instance name are passed as headers. Conference ID as conf_id is passed as a path parameter to uniquely identify the conference

Authorizations:
Authorization
path Parameters
conf_id
required
string non-empty ^(?!\s*$).+
Example: 6e19e88d-634f-4872-826b-2d26503caba1

unique conference id used to identify a conference.

header Parameters
Authorization
required
string non-empty (^[\w-]*\.[\w-]*\.[\w-]*$)
Example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

Auth JWT token from IDP

x-hoot-instance
required
string
Default: Generic
Enum: "Generic" "Speakerbus" "Melco"
Example: Generic

Instance name of the requesting entity

Responses

Response samples

Content type
application/json
{
  • "moderators": [
    ],
  • "participants": [
    ]
}

AllConferenceUsers

Use HooT's AllConferenceUsers API to fetch the list of all participants of a conference. The API takes conference ID as conf_id as a path param to identify the conference. If a conference is found with the given conference ID, the API will return an Array of JSON objects containing the name and email of participants in the conference respectively. Authorization-Token and x-hoot-instance that signifies the instance name are passed as headers. Conference ID as conf_id is passed as a path parameter to uniquely identify the conference

Authorizations:
Authorization
path Parameters
conf_id
required
string non-empty ^(?!\s*$).+
Example: 6e19e88d-634f-4872-826b-2d26503caba1

unique conference id used to identify a conference.

header Parameters
Authorization
required
string non-empty (^[\w-]*\.[\w-]*\.[\w-]*$)
Example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

Auth JWT token from IDP

x-hoot-instance
required
string
Default: Generic
Enum: "Generic" "Speakerbus" "Melco"
Example: Generic

Instance name of the requesting entity

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

XformByQueryParam

Get URL conference as query param.

Authorizations:
Authorization
query Parameters
u
required
string

URL of the conference

header Parameters
Authorization
string

Auth JWT token from IDP

x-hoot-instance
required
string
Default: Generic

Instance name of the requesting entity

Responses

Your GET endpoint

Authorizations:
Authorization

Responses

Response samples

Content type
application/json
{
  • "applinks": {
    }
}

Android Asset Link

Authorizations:
Authorization

Responses

Response samples

Content type
application/json
[
  • {
    }
]

SubscribeConference

Request to subscribe to a conference's events. Provide the subscription

Authorizations:
Authorization
path Parameters
conf_id
required
string
header Parameters
Authorization
string

Auth JWT token from IDP

x-hoot-instance
string

Instance name of the requesting entity

Request Body schema: application/json
api_endpoint
required
string^http

https REST endpoint

Responses

Request samples

Content type
application/json

Response samples

Content type
application/json
{}

DeleteSubscription

Authorizations:
Authorization
path Parameters
subscription_id
required
string
header Parameters
Authorization
string

Signed JWT from the IDP

x-hoot-instance
string

hoot instance

Responses